1 | /* SPDX-License-Identifier: GPL-2.0 */ |
2 | /* |
3 | * devfreq_cooling: Thermal cooling device implementation for devices using |
4 | * devfreq |
5 | * |
6 | * Copyright (C) 2014-2015 ARM Limited |
7 | * |
8 | */ |
9 | |
10 | #ifndef __DEVFREQ_COOLING_H__ |
11 | #define __DEVFREQ_COOLING_H__ |
12 | |
13 | #include <linux/devfreq.h> |
14 | #include <linux/thermal.h> |
15 | |
16 | |
17 | /** |
18 | * struct devfreq_cooling_power - Devfreq cooling power ops |
19 | * @get_real_power: When this is set, the framework uses it to ask the |
20 | * device driver for the actual power. |
21 | * Some devices have more sophisticated methods |
22 | * (like power counters) to approximate the actual power |
23 | * that they use. |
24 | * This function provides more accurate data to the |
25 | * thermal governor. When the driver does not provide |
26 | * such function, framework just uses pre-calculated |
27 | * table and scale the power by 'utilization' |
28 | * (based on 'busy_time' and 'total_time' taken from |
29 | * devfreq 'last_status'). |
30 | * The value returned by this function must be lower |
31 | * or equal than the maximum power value |
32 | * for the current state |
33 | * (which can be found in power_table[state]). |
34 | * When this interface is used, the power_table holds |
35 | * max total (static + dynamic) power value for each OPP. |
36 | */ |
37 | struct devfreq_cooling_power { |
38 | int (*get_real_power)(struct devfreq *df, u32 *power, |
39 | unsigned long freq, unsigned long voltage); |
40 | }; |
41 | |
42 | #ifdef CONFIG_DEVFREQ_THERMAL |
43 | |
44 | struct thermal_cooling_device * |
45 | of_devfreq_cooling_register_power(struct device_node *np, struct devfreq *df, |
46 | struct devfreq_cooling_power *dfc_power); |
47 | struct thermal_cooling_device * |
48 | of_devfreq_cooling_register(struct device_node *np, struct devfreq *df); |
49 | struct thermal_cooling_device *devfreq_cooling_register(struct devfreq *df); |
50 | 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_cooling_power *dfc_power); |
54 | |
55 | #else /* !CONFIG_DEVFREQ_THERMAL */ |
56 | |
57 | static inline struct thermal_cooling_device * |
58 | of_devfreq_cooling_register_power(struct device_node *np, struct devfreq *df, |
59 | struct devfreq_cooling_power *dfc_power) |
60 | { |
61 | return ERR_PTR(-EINVAL); |
62 | } |
63 | |
64 | static inline struct thermal_cooling_device * |
65 | of_devfreq_cooling_register(struct device_node *np, struct devfreq *df) |
66 | { |
67 | return ERR_PTR(-EINVAL); |
68 | } |
69 | |
70 | static inline struct thermal_cooling_device * |
71 | 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_cooling_power *dfc_power) |
79 | { |
80 | return ERR_PTR(-EINVAL); |
81 | } |
82 | |
83 | static inline void |
84 | devfreq_cooling_unregister(struct thermal_cooling_device *dfc) |
85 | { |
86 | } |
87 | |
88 | #endif /* CONFIG_DEVFREQ_THERMAL */ |
89 | #endif /* __DEVFREQ_COOLING_H__ */ |
90 | |