1 /* SPDX-License-Identifier: GPL-2.0 */ <<
2 /* 1 /*
3 * devfreq_cooling: Thermal cooling device imp 2 * devfreq_cooling: Thermal cooling device implementation for devices using
4 * devfreq 3 * devfreq
5 * 4 *
6 * Copyright (C) 2014-2015 ARM Limited 5 * Copyright (C) 2014-2015 ARM Limited
7 * 6 *
>> 7 * This program is free software; you can redistribute it and/or modify
>> 8 * it under the terms of the GNU General Public License version 2 as
>> 9 * published by the Free Software Foundation.
>> 10 *
>> 11 * This program is distributed "as is" WITHOUT ANY WARRANTY of any
>> 12 * kind, whether express or implied; without even the implied warranty
>> 13 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
>> 14 * GNU General Public License for more details.
8 */ 15 */
9 16
10 #ifndef __DEVFREQ_COOLING_H__ 17 #ifndef __DEVFREQ_COOLING_H__
11 #define __DEVFREQ_COOLING_H__ 18 #define __DEVFREQ_COOLING_H__
12 19
13 #include <linux/devfreq.h> 20 #include <linux/devfreq.h>
14 #include <linux/thermal.h> 21 #include <linux/thermal.h>
15 22
16 23
17 /** 24 /**
18 * struct devfreq_cooling_power - Devfreq cool 25 * struct devfreq_cooling_power - Devfreq cooling power ops
19 * @get_real_power: When this is set, the !! 26 * @get_static_power: Take voltage, in mV, and return the static power
20 * device driver for the !! 27 * in mW. If NULL, the static power is assumed
21 * Some devices have more !! 28 * to be 0.
22 * (like power counters) !! 29 * @get_dynamic_power: Take voltage, in mV, and frequency, in HZ, and
23 * that they use. !! 30 * return the dynamic power draw in mW. If NULL,
24 * This function provides !! 31 * a simple power model is used.
25 * thermal governor. When !! 32 * @dyn_power_coeff: Coefficient for the simple dynamic power model in
26 * such function, framewo !! 33 * mW/(MHz mV mV).
27 * table and scale the po !! 34 * If get_dynamic_power() is NULL, then the
28 * (based on 'busy_time' !! 35 * dynamic power is calculated as
29 * devfreq 'last_status') !! 36 * @dyn_power_coeff * frequency * voltage^2
30 * The value returned by <<
31 * or equal than the maxi <<
32 * for the current state <<
33 * (which can be found in <<
34 * When this interface is <<
35 * max total (static + dy <<
36 */ 37 */
37 struct devfreq_cooling_power { 38 struct devfreq_cooling_power {
38 int (*get_real_power)(struct devfreq * !! 39 unsigned long (*get_static_power)(struct devfreq *devfreq,
39 unsigned long fr !! 40 unsigned long voltage);
>> 41 unsigned long (*get_dynamic_power)(struct devfreq *devfreq,
>> 42 unsigned long freq,
>> 43 unsigned long voltage);
>> 44 unsigned long dyn_power_coeff;
40 }; 45 };
41 46
42 #ifdef CONFIG_DEVFREQ_THERMAL 47 #ifdef CONFIG_DEVFREQ_THERMAL
43 48
44 struct thermal_cooling_device * 49 struct thermal_cooling_device *
45 of_devfreq_cooling_register_power(struct devic 50 of_devfreq_cooling_register_power(struct device_node *np, struct devfreq *df,
46 struct devfr 51 struct devfreq_cooling_power *dfc_power);
47 struct thermal_cooling_device * 52 struct thermal_cooling_device *
48 of_devfreq_cooling_register(struct device_node 53 of_devfreq_cooling_register(struct device_node *np, struct devfreq *df);
49 struct thermal_cooling_device *devfreq_cooling 54 struct thermal_cooling_device *devfreq_cooling_register(struct devfreq *df);
50 void devfreq_cooling_unregister(struct thermal 55 void devfreq_cooling_unregister(struct thermal_cooling_device *dfc);
51 struct thermal_cooling_device * <<
52 devfreq_cooling_em_register(struct devfreq *df <<
53 struct devfreq_coo <<
54 56
55 #else /* !CONFIG_DEVFREQ_THERMAL */ 57 #else /* !CONFIG_DEVFREQ_THERMAL */
56 58
57 static inline struct thermal_cooling_device * !! 59 struct thermal_cooling_device *
58 of_devfreq_cooling_register_power(struct devic 60 of_devfreq_cooling_register_power(struct device_node *np, struct devfreq *df,
59 struct devfr 61 struct devfreq_cooling_power *dfc_power)
60 { 62 {
61 return ERR_PTR(-EINVAL); 63 return ERR_PTR(-EINVAL);
62 } 64 }
63 65
64 static inline struct thermal_cooling_device * 66 static inline struct thermal_cooling_device *
65 of_devfreq_cooling_register(struct device_node 67 of_devfreq_cooling_register(struct device_node *np, struct devfreq *df)
66 { 68 {
67 return ERR_PTR(-EINVAL); 69 return ERR_PTR(-EINVAL);
68 } 70 }
69 71
70 static inline struct thermal_cooling_device * 72 static inline struct thermal_cooling_device *
71 devfreq_cooling_register(struct devfreq *df) 73 devfreq_cooling_register(struct devfreq *df)
72 { <<
73 return ERR_PTR(-EINVAL); <<
74 } <<
75 <<
76 static inline struct thermal_cooling_device * <<
77 devfreq_cooling_em_register(struct devfreq *df <<
78 struct devfreq_coo <<
79 { 74 {
80 return ERR_PTR(-EINVAL); 75 return ERR_PTR(-EINVAL);
81 } 76 }
82 77
83 static inline void 78 static inline void
84 devfreq_cooling_unregister(struct thermal_cool 79 devfreq_cooling_unregister(struct thermal_cooling_device *dfc)
85 { 80 {
86 } 81 }
87 82
88 #endif /* CONFIG_DEVFREQ_THERMAL */ 83 #endif /* CONFIG_DEVFREQ_THERMAL */
89 #endif /* __DEVFREQ_COOLING_H__ */ 84 #endif /* __DEVFREQ_COOLING_H__ */
90 85
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.