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