]>
Commit | Line | Data |
---|---|---|
d2912cb1 | 1 | /* SPDX-License-Identifier: GPL-2.0-only */ |
f59d3ee8 VK |
2 | /* |
3 | * Generic OPP Interface | |
4 | * | |
5 | * Copyright (C) 2009-2010 Texas Instruments Incorporated. | |
6 | * Nishanth Menon | |
7 | * Romit Dasgupta | |
8 | * Kevin Hilman | |
f59d3ee8 VK |
9 | */ |
10 | ||
11 | #ifndef __DRIVER_OPP_H__ | |
12 | #define __DRIVER_OPP_H__ | |
13 | ||
14 | #include <linux/device.h> | |
6d3f922c | 15 | #include <linux/interconnect.h> |
f59d3ee8 | 16 | #include <linux/kernel.h> |
7034764a | 17 | #include <linux/kref.h> |
f59d3ee8 | 18 | #include <linux/list.h> |
deaa5146 | 19 | #include <linux/limits.h> |
f59d3ee8 | 20 | #include <linux/pm_opp.h> |
052c6f19 | 21 | #include <linux/notifier.h> |
f59d3ee8 | 22 | |
d54974c2 | 23 | struct clk; |
9f8ea969 VK |
24 | struct regulator; |
25 | ||
87b4115d | 26 | /* Lock to allow exclusive modification to the device and opp lists */ |
2c2709dc | 27 | extern struct mutex opp_table_lock; |
87b4115d | 28 | |
7eba0c76 | 29 | extern struct list_head opp_tables, lazy_opp_tables; |
f47b72a1 | 30 | |
f59d3ee8 VK |
31 | /* |
32 | * Internal data structure organization with the OPP layer library is as | |
33 | * follows: | |
2c2709dc | 34 | * opp_tables (root) |
f59d3ee8 VK |
35 | * |- device 1 (represents voltage domain 1) |
36 | * | |- opp 1 (availability, freq, voltage) | |
37 | * | |- opp 2 .. | |
38 | * ... ... | |
39 | * | `- opp n .. | |
40 | * |- device 2 (represents the next voltage domain) | |
41 | * ... | |
42 | * `- device m (represents mth voltage domain) | |
2c2709dc | 43 | * device 1, 2.. are represented by opp_table structure while each opp |
f59d3ee8 VK |
44 | * is represented by the opp structure. |
45 | */ | |
46 | ||
47 | /** | |
48 | * struct dev_pm_opp - Generic OPP description structure | |
2c2709dc | 49 | * @node: opp table node. The nodes are maintained throughout the lifetime |
f59d3ee8 VK |
50 | * of boot. It is expected only an optimal set of OPPs are |
51 | * added to the library by the SoC framework. | |
f59d3ee8 VK |
52 | * IMPORTANT: the opp nodes should be maintained in increasing |
53 | * order. | |
7034764a | 54 | * @kref: for reference count of the OPP. |
f59d3ee8 | 55 | * @available: true/false - marks if this OPP as available or not |
dc4e7b1f | 56 | * @dynamic: not-created from static DT entries. |
f59d3ee8 | 57 | * @turbo: true if turbo (boost) OPP |
deaa5146 | 58 | * @suspend: true if suspend OPP |
606a5d42 | 59 | * @removed: flag indicating that OPP's reference is dropped by OPP core. |
009acd19 | 60 | * @pstate: Device's power domain's performance state. |
f59d3ee8 | 61 | * @rate: Frequency in hertz |
5b93ac54 | 62 | * @level: Performance level |
dfbe4678 | 63 | * @supplies: Power supplies voltage/current values |
6d3f922c | 64 | * @bandwidth: Interconnect bandwidth values |
f59d3ee8 VK |
65 | * @clock_latency_ns: Latency (in nanoseconds) of switching to this OPP's |
66 | * frequency from any other OPP's frequency. | |
da544b61 | 67 | * @required_opps: List of OPPs that are required by this OPP. |
2c2709dc | 68 | * @opp_table: points back to the opp_table struct this opp belongs to |
f59d3ee8 | 69 | * @np: OPP's device node. |
deaa5146 | 70 | * @dentry: debugfs dentry pointer (per opp) |
f59d3ee8 VK |
71 | * |
72 | * This structure stores the OPP information for a given device. | |
73 | */ | |
74 | struct dev_pm_opp { | |
75 | struct list_head node; | |
7034764a | 76 | struct kref kref; |
f59d3ee8 VK |
77 | |
78 | bool available; | |
79 | bool dynamic; | |
80 | bool turbo; | |
deaa5146 | 81 | bool suspend; |
606a5d42 | 82 | bool removed; |
009acd19 | 83 | unsigned int pstate; |
f59d3ee8 | 84 | unsigned long rate; |
5b93ac54 | 85 | unsigned int level; |
f59d3ee8 | 86 | |
dfbe4678 | 87 | struct dev_pm_opp_supply *supplies; |
6d3f922c | 88 | struct dev_pm_opp_icc_bw *bandwidth; |
0f0fe7e0 | 89 | |
f59d3ee8 VK |
90 | unsigned long clock_latency_ns; |
91 | ||
da544b61 | 92 | struct dev_pm_opp **required_opps; |
2c2709dc | 93 | struct opp_table *opp_table; |
f59d3ee8 VK |
94 | |
95 | struct device_node *np; | |
deaa5146 VK |
96 | |
97 | #ifdef CONFIG_DEBUG_FS | |
98 | struct dentry *dentry; | |
99 | #endif | |
f59d3ee8 VK |
100 | }; |
101 | ||
102 | /** | |
2c2709dc | 103 | * struct opp_device - devices managed by 'struct opp_table' |
f59d3ee8 VK |
104 | * @node: list node |
105 | * @dev: device to which the struct object belongs | |
deaa5146 | 106 | * @dentry: debugfs dentry pointer (per device) |
f59d3ee8 | 107 | * |
2c2709dc VK |
108 | * This is an internal data structure maintaining the devices that are managed |
109 | * by 'struct opp_table'. | |
f59d3ee8 | 110 | */ |
2c2709dc | 111 | struct opp_device { |
f59d3ee8 VK |
112 | struct list_head node; |
113 | const struct device *dev; | |
deaa5146 VK |
114 | |
115 | #ifdef CONFIG_DEBUG_FS | |
116 | struct dentry *dentry; | |
117 | #endif | |
f59d3ee8 VK |
118 | }; |
119 | ||
79ee2e8f VK |
120 | enum opp_table_access { |
121 | OPP_TABLE_ACCESS_UNKNOWN = 0, | |
122 | OPP_TABLE_ACCESS_EXCLUSIVE = 1, | |
123 | OPP_TABLE_ACCESS_SHARED = 2, | |
124 | }; | |
125 | ||
f59d3ee8 | 126 | /** |
2c2709dc VK |
127 | * struct opp_table - Device opp structure |
128 | * @node: table node - contains the devices with OPPs that | |
f59d3ee8 | 129 | * have been registered. Nodes once added are not modified in this |
2c2709dc | 130 | * table. |
052c6f19 | 131 | * @head: notifier head to notify the OPP availability changes. |
f59d3ee8 | 132 | * @dev_list: list of devices that share these OPPs |
2c2709dc | 133 | * @opp_list: table of opps |
f067a982 | 134 | * @kref: for reference count of the table. |
3d255699 | 135 | * @lock: mutex protecting the opp_list and dev_list. |
f59d3ee8 | 136 | * @np: struct device_node pointer for opp's DT node. |
dc4e7b1f | 137 | * @clock_latency_ns_max: Max clock latency in nanoseconds. |
03758d60 | 138 | * @parsed_static_opps: Count of devices for which OPPs are initialized from DT. |
f59d3ee8 | 139 | * @shared_opp: OPP is shared between multiple devices. |
de04241a | 140 | * @current_rate: Currently configured frequency. |
81c4d8a3 | 141 | * @current_opp: Currently configured OPP for the table. |
dc4e7b1f | 142 | * @suspend_opp: Pointer to OPP to be used during device suspend. |
4f018bc0 VK |
143 | * @genpd_virt_dev_lock: Mutex protecting the genpd virtual device pointers. |
144 | * @genpd_virt_devs: List of virtual devices for multiple genpd support. | |
5d6d106f VK |
145 | * @required_opp_tables: List of device OPP tables that are required by OPPs in |
146 | * this table. | |
147 | * @required_opp_count: Number of required devices. | |
7de36b0a VK |
148 | * @supported_hw: Array of version number to support. |
149 | * @supported_hw_count: Number of elements in supported_hw array. | |
01fb4d3c | 150 | * @prop_name: A name to postfix to many DT properties, while parsing them. |
d54974c2 | 151 | * @clk: Device's clock handle |
dfbe4678 | 152 | * @regulators: Supply regulators |
46f48aca VK |
153 | * @regulator_count: Number of power supply regulators. Its value can be -1 |
154 | * (uninitialized), 0 (no opp-microvolt property) or > 0 (has opp-microvolt | |
155 | * property). | |
6d3f922c GD |
156 | * @paths: Interconnect path handles |
157 | * @path_count: Number of interconnect paths | |
72f80ce4 | 158 | * @enabled: Set to true if the device's resources are enabled/configured. |
009acd19 | 159 | * @genpd_performance_state: Device's power domain support performance state. |
61d8e7c7 | 160 | * @is_genpd: Marks if the OPP table belongs to a genpd. |
4dab160e | 161 | * @set_opp: Platform specific set_opp callback |
38bb3439 | 162 | * @sod_supplies: Set opp data supplies |
94735585 | 163 | * @set_opp_data: Data to be passed to set_opp callback |
deaa5146 VK |
164 | * @dentry: debugfs dentry pointer of the real device directory (not links). |
165 | * @dentry_name: Name of the real dentry. | |
f59d3ee8 | 166 | * |
50f8cfbd VK |
167 | * @voltage_tolerance_v1: In percentage, for v1 bindings only. |
168 | * | |
f59d3ee8 VK |
169 | * This is an internal data structure maintaining the link to opps attached to |
170 | * a device. This structure is not meant to be shared to users as it is | |
171 | * meant for book keeping and private to OPP library. | |
f59d3ee8 | 172 | */ |
2c2709dc | 173 | struct opp_table { |
7eba0c76 | 174 | struct list_head node, lazy; |
f59d3ee8 | 175 | |
052c6f19 | 176 | struct blocking_notifier_head head; |
f59d3ee8 VK |
177 | struct list_head dev_list; |
178 | struct list_head opp_list; | |
f067a982 | 179 | struct kref kref; |
37a73ec0 | 180 | struct mutex lock; |
f59d3ee8 VK |
181 | |
182 | struct device_node *np; | |
183 | unsigned long clock_latency_ns_max; | |
50f8cfbd VK |
184 | |
185 | /* For backward compatibility with v1 bindings */ | |
186 | unsigned int voltage_tolerance_v1; | |
187 | ||
03758d60 | 188 | unsigned int parsed_static_opps; |
79ee2e8f | 189 | enum opp_table_access shared_opp; |
de04241a | 190 | unsigned long current_rate; |
81c4d8a3 | 191 | struct dev_pm_opp *current_opp; |
f59d3ee8 | 192 | struct dev_pm_opp *suspend_opp; |
deaa5146 | 193 | |
4f018bc0 VK |
194 | struct mutex genpd_virt_dev_lock; |
195 | struct device **genpd_virt_devs; | |
5d6d106f VK |
196 | struct opp_table **required_opp_tables; |
197 | unsigned int required_opp_count; | |
198 | ||
7de36b0a VK |
199 | unsigned int *supported_hw; |
200 | unsigned int supported_hw_count; | |
01fb4d3c | 201 | const char *prop_name; |
d54974c2 | 202 | struct clk *clk; |
dfbe4678 | 203 | struct regulator **regulators; |
46f48aca | 204 | int regulator_count; |
6d3f922c GD |
205 | struct icc_path **paths; |
206 | unsigned int path_count; | |
72f80ce4 | 207 | bool enabled; |
009acd19 | 208 | bool genpd_performance_state; |
61d8e7c7 | 209 | bool is_genpd; |
7de36b0a | 210 | |
4dab160e | 211 | int (*set_opp)(struct dev_pm_set_opp_data *data); |
38bb3439 | 212 | struct dev_pm_opp_supply *sod_supplies; |
94735585 VK |
213 | struct dev_pm_set_opp_data *set_opp_data; |
214 | ||
deaa5146 VK |
215 | #ifdef CONFIG_DEBUG_FS |
216 | struct dentry *dentry; | |
217 | char dentry_name[NAME_MAX]; | |
218 | #endif | |
f59d3ee8 VK |
219 | }; |
220 | ||
221 | /* Routines internal to opp core */ | |
a88bd2a5 | 222 | void dev_pm_opp_get(struct dev_pm_opp *opp); |
922ff075 | 223 | bool _opp_remove_all_static(struct opp_table *opp_table); |
f067a982 | 224 | void _get_opp_table_kref(struct opp_table *opp_table); |
a1e8c136 | 225 | int _get_opp_count(struct opp_table *opp_table); |
2c2709dc VK |
226 | struct opp_table *_find_opp_table(struct device *dev); |
227 | struct opp_device *_add_opp_dev(const struct device *dev, struct opp_table *opp_table); | |
8cd2f6e8 VK |
228 | struct dev_pm_opp *_opp_allocate(struct opp_table *opp_table); |
229 | void _opp_free(struct dev_pm_opp *opp); | |
6c591eec | 230 | int _opp_compare_key(struct dev_pm_opp *opp1, struct dev_pm_opp *opp2); |
a1e8c136 | 231 | int _opp_add(struct device *dev, struct dev_pm_opp *new_opp, struct opp_table *opp_table, bool rate_not_available); |
8cd2f6e8 | 232 | int _opp_add_v1(struct opp_table *opp_table, struct device *dev, unsigned long freq, long u_volt, bool dynamic); |
2a4eb735 | 233 | void _dev_pm_opp_cpumask_remove_table(const struct cpumask *cpumask, int last_cpu); |
32439ac7 | 234 | struct opp_table *_add_opp_table_indexed(struct device *dev, int index, bool getclk); |
d0e8ae6c | 235 | void _put_opp_list_kref(struct opp_table *opp_table); |
7eba0c76 VK |
236 | void _required_opps_available(struct dev_pm_opp *opp, int count); |
237 | ||
238 | static inline bool lazy_linking_pending(struct opp_table *opp_table) | |
239 | { | |
240 | return unlikely(!list_empty(&opp_table->lazy)); | |
241 | } | |
f47b72a1 VK |
242 | |
243 | #ifdef CONFIG_OF | |
eb7c8743 | 244 | void _of_init_opp_table(struct opp_table *opp_table, struct device *dev, int index); |
5d6d106f | 245 | void _of_clear_opp_table(struct opp_table *opp_table); |
283d55e6 | 246 | struct opp_table *_managed_opp(struct device *dev, int index); |
da544b61 VK |
247 | void _of_opp_free_required_opps(struct opp_table *opp_table, |
248 | struct dev_pm_opp *opp); | |
f47b72a1 | 249 | #else |
eb7c8743 | 250 | static inline void _of_init_opp_table(struct opp_table *opp_table, struct device *dev, int index) {} |
5d6d106f | 251 | static inline void _of_clear_opp_table(struct opp_table *opp_table) {} |
283d55e6 | 252 | static inline struct opp_table *_managed_opp(struct device *dev, int index) { return NULL; } |
da544b61 VK |
253 | static inline void _of_opp_free_required_opps(struct opp_table *opp_table, |
254 | struct dev_pm_opp *opp) {} | |
f47b72a1 | 255 | #endif |
f59d3ee8 | 256 | |
deaa5146 VK |
257 | #ifdef CONFIG_DEBUG_FS |
258 | void opp_debug_remove_one(struct dev_pm_opp *opp); | |
a2dea4cb GKH |
259 | void opp_debug_create_one(struct dev_pm_opp *opp, struct opp_table *opp_table); |
260 | void opp_debug_register(struct opp_device *opp_dev, struct opp_table *opp_table); | |
2c2709dc | 261 | void opp_debug_unregister(struct opp_device *opp_dev, struct opp_table *opp_table); |
deaa5146 VK |
262 | #else |
263 | static inline void opp_debug_remove_one(struct dev_pm_opp *opp) {} | |
264 | ||
a2dea4cb GKH |
265 | static inline void opp_debug_create_one(struct dev_pm_opp *opp, |
266 | struct opp_table *opp_table) { } | |
267 | ||
268 | static inline void opp_debug_register(struct opp_device *opp_dev, | |
269 | struct opp_table *opp_table) { } | |
deaa5146 | 270 | |
2c2709dc VK |
271 | static inline void opp_debug_unregister(struct opp_device *opp_dev, |
272 | struct opp_table *opp_table) | |
deaa5146 VK |
273 | { } |
274 | #endif /* DEBUG_FS */ | |
275 | ||
f59d3ee8 | 276 | #endif /* __DRIVER_OPP_H__ */ |