Blame view
include/clk.h
15.2 KB
83d290c56 SPDX: Convert all... |
1 |
/* SPDX-License-Identifier: GPL-2.0+ */ |
f26c8a8e7 dm: Add a clock u... |
2 3 4 |
/* * Copyright (c) 2015 Google, Inc * Written by Simon Glass <sjg@chromium.org> |
135aa9500 clk: convert API ... |
5 |
* Copyright (c) 2016, NVIDIA CORPORATION. |
f26c8a8e7 dm: Add a clock u... |
6 |
*/ |
08d0d6f32 common: Add new c... |
7 8 |
#ifndef _CLK_H_ #define _CLK_H_ |
75f98314f clk: Get the CLK ... |
9 |
#include <dm/ofnode.h> |
1221ce459 treewide: replace... |
10 |
#include <linux/errno.h> |
ad1cf7858 clk: add needed i... |
11 |
#include <linux/types.h> |
135aa9500 clk: convert API ... |
12 13 14 15 16 17 18 19 |
/** * A clock is a hardware signal that oscillates autonomously at a specific * frequency and duty cycle. Most hardware modules require one or more clock * signal to drive their operation. Clock signals are typically generated * externally to the HW module consuming them, by an entity this API calls a * clock provider. This API provides a standard means for drivers to enable and * disable clocks, and to set the rate at which they oscillate. * |
a9092710c dm: Fix documenta... |
20 |
* A driver that implements UCLASS_CLK is a clock provider. A provider will |
135aa9500 clk: convert API ... |
21 |
* often implement multiple separate clocks, since the hardware it manages |
9bf865067 include/clk.h: Fi... |
22 |
* often has this capability. clk-uclass.h describes the interface which |
135aa9500 clk: convert API ... |
23 24 25 26 27 |
* clock providers must implement. * * Clock consumers/clients are the HW modules driven by the clock signals. This * header file describes the API used by drivers for those HW modules. */ |
ad1cf7858 clk: add needed i... |
28 |
|
135aa9500 clk: convert API ... |
29 |
struct udevice; |
08d0d6f32 common: Add new c... |
30 |
|
135aa9500 clk: convert API ... |
31 32 33 34 35 36 37 38 39 |
/** * struct clk - A handle to (allowing control of) a single clock. * * Clients provide storage for clock handles. The content of the structure is * managed solely by the clock API and clock drivers. A clock struct is * initialized by "get"ing the clock struct. The clock struct is passed to all * other clock APIs to identify which clock signal to operate upon. * * @dev: The device which implements the clock signal. |
105db9593 clk: Extend struc... |
40 |
* @rate: The clock rate (in HZ). |
a8592cdd5 clk: Extend struc... |
41 42 43 |
* @flags: Flags used across common clock structure (e.g. CLK_) * Clock IP blocks specific flags (i.e. mux, div, gate, etc) are defined * in struct's for those devices (e.g. struct clk_mux). |
135aa9500 clk: convert API ... |
44 |
* @id: The clock signal ID within the provider. |
3b3969bd3 clk: Extend clock... |
45 46 47 |
* @data: An optional data field for scenarios where a single integer ID is not * sufficient. If used, it can be populated through an .of_xlate op and * processed during the various clock ops. |
135aa9500 clk: convert API ... |
48 |
* |
3b3969bd3 clk: Extend clock... |
49 50 |
* Should additional information to identify and configure any clock signal * for any provider be required in the future, the struct could be expanded to |
135aa9500 clk: convert API ... |
51 52 53 54 55 56 57 58 |
* either (a) add more fields to allow clock providers to store additional * information, or (b) replace the id field with an opaque pointer, which the * provider would dynamically allocated during its .of_xlate op, and process * during is .request op. This may require the addition of an extra op to clean * up the allocation. */ struct clk { struct udevice *dev; |
105db9593 clk: Extend struc... |
59 |
long long rate; /* in HZ */ |
a8592cdd5 clk: Extend struc... |
60 |
u32 flags; |
e6849e2fd clk: introduce en... |
61 |
int enable_count; |
135aa9500 clk: convert API ... |
62 |
/* |
3b3969bd3 clk: Extend clock... |
63 |
* Written by of_xlate. In the future, we might add more fields here. |
f26c8a8e7 dm: Add a clock u... |
64 |
*/ |
135aa9500 clk: convert API ... |
65 |
unsigned long id; |
3b3969bd3 clk: Extend clock... |
66 |
unsigned long data; |
f26c8a8e7 dm: Add a clock u... |
67 |
}; |
a855be87d clk: Add get/enab... |
68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 |
/** * struct clk_bulk - A handle to (allowing control of) a bulk of clocks. * * Clients provide storage for the clock bulk. The content of the structure is * managed solely by the clock API. A clock bulk struct is * initialized by "get"ing the clock bulk struct. * The clock bulk struct is passed to all other bulk clock APIs to apply * the API to all the clock in the bulk struct. * * @clks: An array of clock handles. * @count: The number of clock handles in the clks array. */ struct clk_bulk { struct clk *clks; unsigned int count; }; |
3f96f8752 clk: Use dummy cl... |
84 |
#if CONFIG_IS_ENABLED(OF_CONTROL) && CONFIG_IS_ENABLED(CLK) |
0d15463c0 dtoc: Rename the ... |
85 |
struct phandle_1_arg; |
7423daa60 dm: clk: Add supp... |
86 |
int clk_get_by_index_platdata(struct udevice *dev, int index, |
0d15463c0 dtoc: Rename the ... |
87 |
struct phandle_1_arg *cells, struct clk *clk); |
7423daa60 dm: clk: Add supp... |
88 |
|
135aa9500 clk: convert API ... |
89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 |
/** * clock_get_by_index - Get/request a clock by integer index. * * This looks up and requests a clock. The index is relative to the client * device; each device is assumed to have n clocks associated with it somehow, * and this function finds and requests one of them. The mapping of client * device clock indices to provider clocks may be via device-tree properties, * board-provided mapping tables, or some other mechanism. * * @dev: The client device. * @index: The index of the clock to request, within the client's list of * clocks. * @clock A pointer to a clock struct to initialize. * @return 0 if OK, or a negative error code. */ int clk_get_by_index(struct udevice *dev, int index, struct clk *clk); |
f26c8a8e7 dm: Add a clock u... |
105 106 |
/** |
75f98314f clk: Get the CLK ... |
107 108 109 110 111 112 113 114 115 116 117 118 119 120 |
* clock_get_by_index_nodev - Get/request a clock by integer index * without a device. * * This is a version of clk_get_by_index() that does not use a device. * * @node: The client ofnode. * @index: The index of the clock to request, within the client's list of * clocks. * @clock A pointer to a clock struct to initialize. * @return 0 if OK, or a negative error code. */ int clk_get_by_index_nodev(ofnode node, int index, struct clk *clk); /** |
a855be87d clk: Add get/enab... |
121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 |
* clock_get_bulk - Get/request all clocks of a device. * * This looks up and requests all clocks of the client device; each device is * assumed to have n clocks associated with it somehow, and this function finds * and requests all of them in a separate structure. The mapping of client * device clock indices to provider clocks may be via device-tree properties, * board-provided mapping tables, or some other mechanism. * * @dev: The client device. * @bulk A pointer to a clock bulk struct to initialize. * @return 0 if OK, or a negative error code. */ int clk_get_bulk(struct udevice *dev, struct clk_bulk *bulk); /** |
135aa9500 clk: convert API ... |
136 |
* clock_get_by_name - Get/request a clock by name. |
f26c8a8e7 dm: Add a clock u... |
137 |
* |
135aa9500 clk: convert API ... |
138 139 140 141 142 143 144 145 146 147 148 |
* This looks up and requests a clock. The name is relative to the client * device; each device is assumed to have n clocks associated with it somehow, * and this function finds and requests one of them. The mapping of client * device clock names to provider clocks may be via device-tree properties, * board-provided mapping tables, or some other mechanism. * * @dev: The client device. * @name: The name of the clock to request, within the client's list of * clocks. * @clock: A pointer to a clock struct to initialize. * @return 0 if OK, or a negative error code. |
f26c8a8e7 dm: Add a clock u... |
149 |
*/ |
135aa9500 clk: convert API ... |
150 |
int clk_get_by_name(struct udevice *dev, const char *name, struct clk *clk); |
b108d8a0d clk: fix compilat... |
151 152 |
/** |
d646420e2 clk: add APIs to ... |
153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 |
* clk_get_by_name_nodev - Get/request a clock by name without a device. * * This is a version of clk_get_by_name() that does not use a device. * * @node: The client ofnode. * @name: The name of the clock to request, within the client's list of * clocks. * @clock: A pointer to a clock struct to initialize. * @return 0 if OK, or a negative error code. */ int clk_get_by_name_nodev(ofnode node, const char *name, struct clk *clk); /** * clock_get_optional_nodev - Get/request an optinonal clock by name * without a device. * @node: The client ofnode. * @name: The name of the clock to request. * @name: The name of the clock to request, within the client's list of * clocks. * @clock: A pointer to a clock struct to initialize. * * Behaves the same as clk_get_by_name_nodev() except where there is * no clock producer, in this case, skip the error number -ENODATA, and * the function returns 0. */ int clk_get_optional_nodev(ofnode node, const char *name, struct clk *clk); /** |
52720c536 drivers: clk: Add... |
181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 |
* devm_clk_get - lookup and obtain a managed reference to a clock producer. * @dev: device for clock "consumer" * @id: clock consumer ID * * Returns a struct clk corresponding to the clock producer, or * valid IS_ERR() condition containing errno. The implementation * uses @dev and @id to determine the clock consumer, and thereby * the clock producer. (IOW, @id may be identical strings, but * clk_get may return different clock producers depending on @dev.) * * Drivers must assume that the clock source is not enabled. * * devm_clk_get should not be called from within interrupt context. * * The clock will automatically be freed when the device is unbound * from the bus. */ struct clk *devm_clk_get(struct udevice *dev, const char *id); /** * devm_clk_get_optional - lookup and obtain a managed reference to an optional * clock producer. * @dev: device for clock "consumer" * @id: clock consumer ID * * Behaves the same as devm_clk_get() except where there is no clock producer. * In this case, instead of returning -ENOENT, the function returns NULL. */ struct clk *devm_clk_get_optional(struct udevice *dev, const char *id); /** |
b108d8a0d clk: fix compilat... |
212 213 214 215 216 217 218 219 220 221 222 223 |
* clk_release_all() - Disable (turn off)/Free an array of previously * requested clocks. * * For each clock contained in the clock array, this function will check if * clock has been previously requested and then will disable and free it. * * @clk: A clock struct array that was previously successfully * requested by clk_request/get_by_*(). * @count Number of clock contained in the array * @return zero on success, or -ve error code. */ int clk_release_all(struct clk *clk, int count); |
52720c536 drivers: clk: Add... |
224 225 226 227 228 229 230 231 232 233 234 235 |
/** * devm_clk_put - "free" a managed clock source * @dev: device used to acquire the clock * @clk: clock source acquired with devm_clk_get() * * Note: drivers must ensure that all clk_enable calls made on this * clock source are balanced by clk_disable calls prior to calling * this function. * * clk_put should not be called from within interrupt context. */ void devm_clk_put(struct udevice *dev, struct clk *clk); |
021abf696 Revert "ns16650: ... |
236 237 238 239 240 241 |
#else static inline int clk_get_by_index(struct udevice *dev, int index, struct clk *clk) { return -ENOSYS; } |
a855be87d clk: Add get/enab... |
242 243 244 245 |
static inline int clk_get_bulk(struct udevice *dev, struct clk_bulk *bulk) { return -ENOSYS; } |
021abf696 Revert "ns16650: ... |
246 247 248 249 250 |
static inline int clk_get_by_name(struct udevice *dev, const char *name, struct clk *clk) { return -ENOSYS; } |
b108d8a0d clk: fix compilat... |
251 |
|
d646420e2 clk: add APIs to ... |
252 253 254 255 256 257 258 259 260 261 262 |
static inline int clk_get_by_name_nodev(ofnode node, const char *name, struct clk *clk) { return -ENOSYS; } static inline int clk_get_optional_nodev(ofnode node, const char *name, struct clk *clk) { return -ENOSYS; } |
b108d8a0d clk: fix compilat... |
263 264 265 266 |
static inline int clk_release_all(struct clk *clk, int count) { return -ENOSYS; } |
021abf696 Revert "ns16650: ... |
267 |
#endif |
f26c8a8e7 dm: Add a clock u... |
268 |
|
f4fcba5c5 clk: implement cl... |
269 270 271 272 273 274 275 276 |
#if (CONFIG_IS_ENABLED(OF_CONTROL) && !CONFIG_IS_ENABLED(OF_PLATDATA)) && \ CONFIG_IS_ENABLED(CLK) /** * clk_set_defaults - Process 'assigned-{clocks/clock-parents/clock-rates}' * properties to configure clocks * * @dev: A device to process (the ofnode associated with this device * will be processed). |
fd1ba2965 drivers: clk: Fix... |
277 278 279 |
* @stage: A integer. 0 indicates that this is called before the device * is probed. 1 indicates that this is called just after the * device has been probed |
f4fcba5c5 clk: implement cl... |
280 |
*/ |
fd1ba2965 drivers: clk: Fix... |
281 |
int clk_set_defaults(struct udevice *dev, int stage); |
f4fcba5c5 clk: implement cl... |
282 |
#else |
fd1ba2965 drivers: clk: Fix... |
283 |
static inline int clk_set_defaults(struct udevice *dev, int stage) |
f4fcba5c5 clk: implement cl... |
284 285 286 287 |
{ return 0; } #endif |
f26c8a8e7 dm: Add a clock u... |
288 |
/** |
a855be87d clk: Add get/enab... |
289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 |
* clk_release_bulk() - Disable (turn off)/Free an array of previously * requested clocks in a clock bulk struct. * * For each clock contained in the clock bulk struct, this function will check * if clock has been previously requested and then will disable and free it. * * @clk: A clock bulk struct that was previously successfully * requested by clk_get_bulk(). * @return zero on success, or -ve error code. */ static inline int clk_release_bulk(struct clk_bulk *bulk) { return clk_release_all(bulk->clks, bulk->count); } /** |
135aa9500 clk: convert API ... |
305 |
* clk_request - Request a clock by provider-specific ID. |
f26c8a8e7 dm: Add a clock u... |
306 |
* |
135aa9500 clk: convert API ... |
307 308 309 310 311 312 313 314 315 316 |
* This requests a clock using a provider-specific ID. Generally, this function * should not be used, since clk_get_by_index/name() provide an interface that * better separates clients from intimate knowledge of clock providers. * However, this function may be useful in core SoC-specific code. * * @dev: The clock provider device. * @clock: A pointer to a clock struct to initialize. The caller must * have already initialized any field in this struct which the * clock provider uses to identify the clock. * @return 0 if OK, or a negative error code. |
f26c8a8e7 dm: Add a clock u... |
317 |
*/ |
135aa9500 clk: convert API ... |
318 |
int clk_request(struct udevice *dev, struct clk *clk); |
f26c8a8e7 dm: Add a clock u... |
319 320 |
/** |
135aa9500 clk: convert API ... |
321 |
* clock_free - Free a previously requested clock. |
f0e075162 clk: add API to e... |
322 |
* |
135aa9500 clk: convert API ... |
323 324 325 |
* @clock: A clock struct that was previously successfully requested by * clk_request/get_by_*(). * @return 0 if OK, or a negative error code. |
f0e075162 clk: add API to e... |
326 |
*/ |
135aa9500 clk: convert API ... |
327 |
int clk_free(struct clk *clk); |
f0e075162 clk: add API to e... |
328 329 |
/** |
135aa9500 clk: convert API ... |
330 |
* clk_get_rate() - Get current clock rate. |
f26c8a8e7 dm: Add a clock u... |
331 |
* |
135aa9500 clk: convert API ... |
332 333 334 |
* @clk: A clock struct that was previously successfully requested by * clk_request/get_by_*(). * @return clock rate in Hz, or -ve error code. |
f26c8a8e7 dm: Add a clock u... |
335 |
*/ |
135aa9500 clk: convert API ... |
336 |
ulong clk_get_rate(struct clk *clk); |
f26c8a8e7 dm: Add a clock u... |
337 338 |
/** |
0c660c2b3 dm: clk: Define c... |
339 340 341 342 343 344 345 346 347 |
* clk_get_parent() - Get current clock's parent. * * @clk: A clock struct that was previously successfully requested by * clk_request/get_by_*(). * @return pointer to parent's struct clk, or error code passed as pointer */ struct clk *clk_get_parent(struct clk *clk); /** |
4aa78300a dm: clk: Define c... |
348 349 350 351 352 353 354 355 356 |
* clk_get_parent_rate() - Get parent of current clock rate. * * @clk: A clock struct that was previously successfully requested by * clk_request/get_by_*(). * @return clock rate in Hz, or -ve error code. */ long long clk_get_parent_rate(struct clk *clk); /** |
135aa9500 clk: convert API ... |
357 |
* clk_set_rate() - Set current clock rate. |
f26c8a8e7 dm: Add a clock u... |
358 |
* |
135aa9500 clk: convert API ... |
359 360 361 362 |
* @clk: A clock struct that was previously successfully requested by * clk_request/get_by_*(). * @rate: New clock rate in Hz. * @return new rate, or -ve error code. |
f26c8a8e7 dm: Add a clock u... |
363 |
*/ |
135aa9500 clk: convert API ... |
364 |
ulong clk_set_rate(struct clk *clk, ulong rate); |
f26c8a8e7 dm: Add a clock u... |
365 |
|
e70cc4383 dm: clk: Add supp... |
366 |
/** |
f7d1046da clk: add clk_set_... |
367 368 369 370 371 372 373 374 375 376 377 |
* clk_set_parent() - Set current clock parent. * * @clk: A clock struct that was previously successfully requested by * clk_request/get_by_*(). * @parent: A clock struct that was previously successfully requested by * clk_request/get_by_*(). * @return new rate, or -ve error code. */ int clk_set_parent(struct clk *clk, struct clk *parent); /** |
135aa9500 clk: convert API ... |
378 |
* clk_enable() - Enable (turn on) a clock. |
e70cc4383 dm: clk: Add supp... |
379 |
* |
135aa9500 clk: convert API ... |
380 381 382 383 384 385 386 |
* @clk: A clock struct that was previously successfully requested by * clk_request/get_by_*(). * @return zero on success, or -ve error code. */ int clk_enable(struct clk *clk); /** |
a855be87d clk: Add get/enab... |
387 388 389 390 391 392 393 394 395 |
* clk_enable_bulk() - Enable (turn on) all clocks in a clock bulk struct. * * @bulk: A clock bulk struct that was previously successfully requested * by clk_get_bulk(). * @return zero on success, or -ve error code. */ int clk_enable_bulk(struct clk_bulk *bulk); /** |
135aa9500 clk: convert API ... |
396 |
* clk_disable() - Disable (turn off) a clock. |
e70cc4383 dm: clk: Add supp... |
397 |
* |
135aa9500 clk: convert API ... |
398 399 400 |
* @clk: A clock struct that was previously successfully requested by * clk_request/get_by_*(). * @return zero on success, or -ve error code. |
e70cc4383 dm: clk: Add supp... |
401 |
*/ |
135aa9500 clk: convert API ... |
402 |
int clk_disable(struct clk *clk); |
e70cc4383 dm: clk: Add supp... |
403 |
|
a855be87d clk: Add get/enab... |
404 405 406 407 408 409 410 411 |
/** * clk_disable_bulk() - Disable (turn off) all clocks in a clock bulk struct. * * @bulk: A clock bulk struct that was previously successfully requested * by clk_get_bulk(). * @return zero on success, or -ve error code. */ int clk_disable_bulk(struct clk_bulk *bulk); |
acbb7cd4d clk: add support ... |
412 413 414 415 416 417 418 419 420 421 422 |
/** * clk_is_match - check if two clk's point to the same hardware clock * @p: clk compared against q * @q: clk compared against p * * Returns true if the two struct clk pointers both point to the same hardware * clock node. * * Returns false otherwise. Note that two NULL clks are treated as matching. */ bool clk_is_match(const struct clk *p, const struct clk *q); |
135aa9500 clk: convert API ... |
423 |
int soc_clk_dump(void); |
1fe243a1e clk: add clk_valid() |
424 425 426 427 428 429 430 431 |
/** * clk_valid() - check if clk is valid * * @clk: the clock to check * @return true if valid, or false */ static inline bool clk_valid(struct clk *clk) { |
8a1661f20 drivers: clk: Han... |
432 |
return clk && !!clk->dev; |
1fe243a1e clk: add clk_valid() |
433 |
} |
2796af736 dm: clk: Define c... |
434 435 436 437 438 439 440 441 442 443 444 |
/** * clk_get_by_id() - Get the clock by its ID * * @id: The clock ID to search for * * @clkp: A pointer to clock struct that has been found among added clocks * to UCLASS_CLK * @return zero on success, or -ENOENT on error */ int clk_get_by_id(ulong id, struct clk **clkp); |
2457612d6 clk: introduce cl... |
445 446 447 448 449 450 451 452 453 |
/** * clk_dev_binded() - Check whether the clk has a device binded * * @clk A pointer to the clk * * @return true on binded, or false on no */ bool clk_dev_binded(struct clk *clk); |
135aa9500 clk: convert API ... |
454 |
#endif |
52720c536 drivers: clk: Add... |
455 456 457 |
#define clk_prepare_enable(clk) clk_enable(clk) #define clk_disable_unprepare(clk) clk_disable(clk) |