blob: 249c0e0ab4252a713ada78fb3736a102a1b742a7 [file] [log] [blame]
Tom Rini83d290c2018-05-06 17:58:06 -04001/* SPDX-License-Identifier: GPL-2.0+ */
Simon Glassf26c8a82015-06-23 15:39:15 -06002/*
3 * Copyright (c) 2015 Google, Inc
4 * Written by Simon Glass <sjg@chromium.org>
Stephen Warren135aa952016-06-17 09:44:00 -06005 * Copyright (c) 2016, NVIDIA CORPORATION.
Simon Glassf26c8a82015-06-23 15:39:15 -06006 */
7
Michal Simek08d0d6f2013-11-21 13:39:02 -08008#ifndef _CLK_H_
9#define _CLK_H_
10
Jagan Teki75f98312019-02-28 00:26:52 +053011#include <dm/ofnode.h>
Patrick Delaunay6f791742020-04-27 15:29:57 +020012#include <linux/err.h>
Masahiro Yamada1221ce42016-09-21 11:28:55 +090013#include <linux/errno.h>
Masahiro Yamadaad1cf782016-01-13 13:16:09 +090014#include <linux/types.h>
15
Stephen Warren135aa952016-06-17 09:44:00 -060016/**
Sean Anderson9c88b132021-12-22 12:11:12 -050017 * DOC: Overview
18 *
Stephen Warren135aa952016-06-17 09:44:00 -060019 * A clock is a hardware signal that oscillates autonomously at a specific
20 * frequency and duty cycle. Most hardware modules require one or more clock
21 * signal to drive their operation. Clock signals are typically generated
22 * externally to the HW module consuming them, by an entity this API calls a
23 * clock provider. This API provides a standard means for drivers to enable and
24 * disable clocks, and to set the rate at which they oscillate.
25 *
Lukasz Majewskia9092712019-06-24 15:50:36 +020026 * A driver that implements UCLASS_CLK is a clock provider. A provider will
Stephen Warren135aa952016-06-17 09:44:00 -060027 * often implement multiple separate clocks, since the hardware it manages
Liviu Dudau9bf86502018-09-17 17:43:08 +010028 * often has this capability. clk-uclass.h describes the interface which
Stephen Warren135aa952016-06-17 09:44:00 -060029 * clock providers must implement.
30 *
31 * Clock consumers/clients are the HW modules driven by the clock signals. This
32 * header file describes the API used by drivers for those HW modules.
33 */
34
Masahiro Yamadaad1cf782016-01-13 13:16:09 +090035struct udevice;
36
Stephen Warren135aa952016-06-17 09:44:00 -060037/**
38 * struct clk - A handle to (allowing control of) a single clock.
Sean Anderson9c88b132021-12-22 12:11:12 -050039 * @dev: The device which implements the clock signal.
40 * @rate: The clock rate (in HZ).
41 * @flags: Flags used across common clock structure (e.g. %CLK_)
42 * Clock IP blocks specific flags (i.e. mux, div, gate, etc) are defined
43 * in struct's for those devices (e.g. &struct clk_mux).
44 * @enable_count: The number of times this clock has been enabled.
45 * @id: The clock signal ID within the provider.
46 * @data: An optional data field for scenarios where a single integer ID is not
47 * sufficient. If used, it can be populated through an .of_xlate op and
48 * processed during the various clock ops.
Stephen Warren135aa952016-06-17 09:44:00 -060049 *
50 * Clients provide storage for clock handles. The content of the structure is
51 * managed solely by the clock API and clock drivers. A clock struct is
52 * initialized by "get"ing the clock struct. The clock struct is passed to all
53 * other clock APIs to identify which clock signal to operate upon.
54 *
Andreas Dannenberg3b3969b2018-08-27 15:57:42 +053055 * Should additional information to identify and configure any clock signal
56 * for any provider be required in the future, the struct could be expanded to
Stephen Warren135aa952016-06-17 09:44:00 -060057 * either (a) add more fields to allow clock providers to store additional
58 * information, or (b) replace the id field with an opaque pointer, which the
59 * provider would dynamically allocated during its .of_xlate op, and process
60 * during is .request op. This may require the addition of an extra op to clean
61 * up the allocation.
62 */
63struct clk {
64 struct udevice *dev;
Lukasz Majewski105db952019-06-24 15:50:38 +020065 long long rate; /* in HZ */
Lukasz Majewskia8592cd2019-06-24 15:50:39 +020066 u32 flags;
Peng Fane6849e22019-08-21 13:35:03 +000067 int enable_count;
Stephen Warren135aa952016-06-17 09:44:00 -060068 /*
Andreas Dannenberg3b3969b2018-08-27 15:57:42 +053069 * Written by of_xlate. In the future, we might add more fields here.
Simon Glassf26c8a82015-06-23 15:39:15 -060070 */
Stephen Warren135aa952016-06-17 09:44:00 -060071 unsigned long id;
Andreas Dannenberg3b3969b2018-08-27 15:57:42 +053072 unsigned long data;
Simon Glassf26c8a82015-06-23 15:39:15 -060073};
74
Neil Armstronga855be82018-04-03 11:44:18 +020075/**
76 * struct clk_bulk - A handle to (allowing control of) a bulk of clocks.
Sean Anderson9c88b132021-12-22 12:11:12 -050077 * @clks: An array of clock handles.
78 * @count: The number of clock handles in the clks array.
Neil Armstronga855be82018-04-03 11:44:18 +020079 *
80 * Clients provide storage for the clock bulk. The content of the structure is
81 * managed solely by the clock API. A clock bulk struct is
82 * initialized by "get"ing the clock bulk struct.
83 * The clock bulk struct is passed to all other bulk clock APIs to apply
84 * the API to all the clock in the bulk struct.
Neil Armstronga855be82018-04-03 11:44:18 +020085 */
86struct clk_bulk {
87 struct clk *clks;
88 unsigned int count;
89};
90
Simon Glass0d154632017-08-29 14:15:56 -060091struct phandle_1_arg;
Dario Binacchic9dc8e72022-09-27 19:18:19 +020092
93#if CONFIG_IS_ENABLED(OF_CONTROL) && CONFIG_IS_ENABLED(CLK)
Simon Glassf0ab8f92021-08-07 07:24:09 -060094/**
95 * clk_get_by_phandle() - Get a clock by its phandle information (of-platadata)
Sean Anderson9c88b132021-12-22 12:11:12 -050096 * @dev: Device containing the phandle
97 * @cells: Phandle info
98 * @clk: A pointer to a clock struct to initialise
Simon Glassf0ab8f92021-08-07 07:24:09 -060099 *
100 * This function is used when of-platdata is enabled.
101 *
102 * This looks up a clock using the phandle info. With dtoc, each phandle in the
Sean Anderson9c88b132021-12-22 12:11:12 -0500103 * 'clocks' property is transformed into an idx representing the device.
104 * For example::
Simon Glassf0ab8f92021-08-07 07:24:09 -0600105 *
106 * clocks = <&dpll_mpu_ck 23>;
107 *
Sean Anderson9c88b132021-12-22 12:11:12 -0500108 * might result in::
Simon Glassf0ab8f92021-08-07 07:24:09 -0600109 *
110 * .clocks = {1, {23}},},
111 *
112 * indicating that the clock is udevice idx 1 in dt-plat.c with an argument of
113 * 23. This function can return a valid clock given the above information. In
114 * this example it would return a clock containing the 'dpll_mpu_ck' device and
115 * the clock ID 23.
116 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100117 * Return: 0 if OK, or a negative error code.
Simon Glassf0ab8f92021-08-07 07:24:09 -0600118 */
119int clk_get_by_phandle(struct udevice *dev, const struct phandle_1_arg *cells,
120 struct clk *clk);
Simon Glass7423daa2016-07-04 11:58:03 -0600121
Simon Glasse70cc432016-01-20 19:43:02 -0700122/**
Simon Glassf0ab8f92021-08-07 07:24:09 -0600123 * clk_get_by_index() - Get/request a clock by integer index.
Sean Anderson9c88b132021-12-22 12:11:12 -0500124 * @dev: The client device.
125 * @index: The index of the clock to request, within the client's list of
126 * clocks.
127 * @clk: A pointer to a clock struct to initialize.
Simon Glasse70cc432016-01-20 19:43:02 -0700128 *
Stephen Warren135aa952016-06-17 09:44:00 -0600129 * This looks up and requests a clock. The index is relative to the client
130 * device; each device is assumed to have n clocks associated with it somehow,
131 * and this function finds and requests one of them. The mapping of client
132 * device clock indices to provider clocks may be via device-tree properties,
133 * board-provided mapping tables, or some other mechanism.
Simon Glasse70cc432016-01-20 19:43:02 -0700134 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100135 * Return: 0 if OK, or a negative error code.
Simon Glasse70cc432016-01-20 19:43:02 -0700136 */
Stephen Warren135aa952016-06-17 09:44:00 -0600137int clk_get_by_index(struct udevice *dev, int index, struct clk *clk);
138
139/**
Sean Anderson9c88b132021-12-22 12:11:12 -0500140 * clk_get_by_index_nodev() - Get/request a clock by integer index without a
141 * device.
Jagan Teki75f98312019-02-28 00:26:52 +0530142 * @node: The client ofnode.
143 * @index: The index of the clock to request, within the client's list of
144 * clocks.
Sean Anderson9c88b132021-12-22 12:11:12 -0500145 * @clk: A pointer to a clock struct to initialize.
146 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100147 * Return: 0 if OK, or a negative error code.
Jagan Teki75f98312019-02-28 00:26:52 +0530148 */
149int clk_get_by_index_nodev(ofnode node, int index, struct clk *clk);
150
151/**
Sean Anderson9c88b132021-12-22 12:11:12 -0500152 * clk_get_bulk() - Get/request all clocks of a device.
153 * @dev: The client device.
154 * @bulk: A pointer to a clock bulk struct to initialize.
Neil Armstronga855be82018-04-03 11:44:18 +0200155 *
156 * This looks up and requests all clocks of the client device; each device is
157 * assumed to have n clocks associated with it somehow, and this function finds
158 * and requests all of them in a separate structure. The mapping of client
159 * device clock indices to provider clocks may be via device-tree properties,
160 * board-provided mapping tables, or some other mechanism.
161 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100162 * Return: 0 if OK, or a negative error code.
Neil Armstronga855be82018-04-03 11:44:18 +0200163 */
164int clk_get_bulk(struct udevice *dev, struct clk_bulk *bulk);
165
166/**
Sean Anderson9c88b132021-12-22 12:11:12 -0500167 * clk_get_by_name() - Get/request a clock by name.
168 * @dev: The client device.
169 * @name: The name of the clock to request, within the client's list of
Samuel Holland2050f822023-01-21 18:02:51 -0600170 * clocks, or NULL to request the first clock in the list.
Sean Anderson9c88b132021-12-22 12:11:12 -0500171 * @clk: A pointer to a clock struct to initialize.
Stephen Warren135aa952016-06-17 09:44:00 -0600172 *
173 * This looks up and requests a clock. The name is relative to the client
174 * device; each device is assumed to have n clocks associated with it somehow,
175 * and this function finds and requests one of them. The mapping of client
176 * device clock names to provider clocks may be via device-tree properties,
177 * board-provided mapping tables, or some other mechanism.
178 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100179 * Return: 0 if OK, or a negative error code.
Stephen Warren135aa952016-06-17 09:44:00 -0600180 */
181int clk_get_by_name(struct udevice *dev, const char *name, struct clk *clk);
Patrice Chotardb108d8a2017-07-25 13:24:45 +0200182
183/**
Chunfeng Yund6464202020-01-09 11:35:07 +0800184 * clk_get_by_name_nodev - Get/request a clock by name without a device.
Chunfeng Yund6464202020-01-09 11:35:07 +0800185 * @node: The client ofnode.
186 * @name: The name of the clock to request, within the client's list of
Samuel Holland2050f822023-01-21 18:02:51 -0600187 * clocks, or NULL to request the first clock in the list.
Sean Anderson9c88b132021-12-22 12:11:12 -0500188 * @clk: A pointer to a clock struct to initialize.
189 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100190 * Return: 0 if OK, or a negative error code.
Chunfeng Yund6464202020-01-09 11:35:07 +0800191 */
192int clk_get_by_name_nodev(ofnode node, const char *name, struct clk *clk);
193
194/**
Sean Anderson9c88b132021-12-22 12:11:12 -0500195 * devm_clk_get() - lookup and obtain a managed reference to a clock producer.
Jean-Jacques Hiblot52720c52019-10-22 14:00:04 +0200196 * @dev: device for clock "consumer"
197 * @id: clock consumer ID
198 *
Sean Anderson9c88b132021-12-22 12:11:12 -0500199 * The implementation uses @dev and @id to determine the clock consumer, and
200 * thereby the clock producer. (IOW, @id may be identical strings, but clk_get
201 * may return different clock producers depending on @dev.)
Jean-Jacques Hiblot52720c52019-10-22 14:00:04 +0200202 *
203 * Drivers must assume that the clock source is not enabled.
204 *
Jean-Jacques Hiblot52720c52019-10-22 14:00:04 +0200205 * The clock will automatically be freed when the device is unbound
206 * from the bus.
Sean Anderson9c88b132021-12-22 12:11:12 -0500207 *
208 * Return:
209 * a struct clk corresponding to the clock producer, or
210 * valid IS_ERR() condition containing errno
Jean-Jacques Hiblot52720c52019-10-22 14:00:04 +0200211 */
212struct clk *devm_clk_get(struct udevice *dev, const char *id);
213
214/**
Sean Anderson9c88b132021-12-22 12:11:12 -0500215 * devm_clk_get_optional() - lookup and obtain a managed reference to an
216 * optional clock producer.
Jean-Jacques Hiblot52720c52019-10-22 14:00:04 +0200217 * @dev: device for clock "consumer"
218 * @id: clock consumer ID
219 *
220 * Behaves the same as devm_clk_get() except where there is no clock producer.
Sean Anderson9c88b132021-12-22 12:11:12 -0500221 * In this case, instead of returning -%ENOENT, the function returns NULL.
Jean-Jacques Hiblot52720c52019-10-22 14:00:04 +0200222 */
Sean Anderson14cacb02021-12-22 12:11:11 -0500223static inline struct clk *devm_clk_get_optional(struct udevice *dev,
224 const char *id)
225{
Yang Xiwenc4b52fd2023-08-18 01:04:02 +0800226 int ret;
Sean Anderson14cacb02021-12-22 12:11:11 -0500227 struct clk *clk = devm_clk_get(dev, id);
228
Yang Xiwenc4b52fd2023-08-18 01:04:02 +0800229 ret = PTR_ERR(clk);
230 if (ret == -ENODATA || ret == -ENOENT)
Sean Anderson14cacb02021-12-22 12:11:11 -0500231 return NULL;
232
233 return clk;
234}
Jean-Jacques Hiblot52720c52019-10-22 14:00:04 +0200235
236/**
Patrice Chotardb108d8a2017-07-25 13:24:45 +0200237 * clk_release_all() - Disable (turn off)/Free an array of previously
238 * requested clocks.
Sean Anderson9c88b132021-12-22 12:11:12 -0500239 * @clk: A clock struct array that was previously successfully
240 * requested by clk_request/get_by_*().
241 * @count: Number of clock contained in the array
Patrice Chotardb108d8a2017-07-25 13:24:45 +0200242 *
243 * For each clock contained in the clock array, this function will check if
244 * clock has been previously requested and then will disable and free it.
245 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100246 * Return: zero on success, or -ve error code.
Patrice Chotardb108d8a2017-07-25 13:24:45 +0200247 */
Eugen Hristevb6a56f52023-06-19 13:47:52 +0300248int clk_release_all(struct clk *clk, unsigned int count);
Patrice Chotardb108d8a2017-07-25 13:24:45 +0200249
Jean-Jacques Hiblot52720c52019-10-22 14:00:04 +0200250/**
251 * devm_clk_put - "free" a managed clock source
252 * @dev: device used to acquire the clock
253 * @clk: clock source acquired with devm_clk_get()
254 *
255 * Note: drivers must ensure that all clk_enable calls made on this
256 * clock source are balanced by clk_disable calls prior to calling
257 * this function.
258 *
259 * clk_put should not be called from within interrupt context.
260 */
261void devm_clk_put(struct udevice *dev, struct clk *clk);
262
Masahiro Yamada021abf62016-09-26 20:45:27 +0900263#else
Dario Binacchic9dc8e72022-09-27 19:18:19 +0200264
265static inline int clk_get_by_phandle(struct udevice *dev, const
266 struct phandle_1_arg *cells,
267 struct clk *clk)
268{
269 return -ENOSYS;
270}
271
Masahiro Yamada021abf62016-09-26 20:45:27 +0900272static inline int clk_get_by_index(struct udevice *dev, int index,
273 struct clk *clk)
274{
275 return -ENOSYS;
276}
277
Dario Binacchic9dc8e72022-09-27 19:18:19 +0200278static inline int clk_get_by_index_nodev(ofnode node, int index,
279 struct clk *clk)
280{
281 return -ENOSYS;
282}
283
Neil Armstronga855be82018-04-03 11:44:18 +0200284static inline int clk_get_bulk(struct udevice *dev, struct clk_bulk *bulk)
285{
286 return -ENOSYS;
287}
288
Masahiro Yamada021abf62016-09-26 20:45:27 +0900289static inline int clk_get_by_name(struct udevice *dev, const char *name,
290 struct clk *clk)
291{
292 return -ENOSYS;
293}
Patrice Chotardb108d8a2017-07-25 13:24:45 +0200294
Dario Binacchic9dc8e72022-09-27 19:18:19 +0200295static inline struct clk *devm_clk_get(struct udevice *dev, const char *id)
296{
297 return ERR_PTR(-ENOSYS);
298}
299
300static inline struct clk *devm_clk_get_optional(struct udevice *dev,
301 const char *id)
302{
303 return ERR_PTR(-ENOSYS);
304}
305
Chunfeng Yund6464202020-01-09 11:35:07 +0800306static inline int
307clk_get_by_name_nodev(ofnode node, const char *name, struct clk *clk)
308{
309 return -ENOSYS;
310}
311
Eugen Hristevb6a56f52023-06-19 13:47:52 +0300312static inline int clk_release_all(struct clk *clk, unsigned int count)
Patrice Chotardb108d8a2017-07-25 13:24:45 +0200313{
314 return -ENOSYS;
315}
Dario Binacchic9dc8e72022-09-27 19:18:19 +0200316
317static inline void devm_clk_put(struct udevice *dev, struct clk *clk)
318{
319}
Masahiro Yamada021abf62016-09-26 20:45:27 +0900320#endif
Simon Glasse70cc432016-01-20 19:43:02 -0700321
Sean Anderson6e33eba2021-06-11 00:16:07 -0400322/**
Sean Andersone96e2132022-01-15 15:52:47 -0500323 * clk_get_by_name_optional() - Get/request a optional clock by name.
324 * @dev: The client device.
325 * @name: The name of the clock to request, within the client's list of
326 * clocks.
327 * @clk: A pointer to a clock struct to initialize.
328 *
329 * Behaves the same as clk_get_by_name(), except when there is no clock
330 * provider. In the latter case, return 0.
331 *
332 * Return: 0 if OK, or a negative error code.
333 */
334static inline int clk_get_by_name_optional(struct udevice *dev,
335 const char *name, struct clk *clk)
336{
337 int ret;
338
339 ret = clk_get_by_name(dev, name, clk);
Yang Xiwenc4b52fd2023-08-18 01:04:02 +0800340 if (ret == -ENODATA || ret == -ENOENT)
Sean Andersone96e2132022-01-15 15:52:47 -0500341 return 0;
342
343 return ret;
344}
345
346/**
Sean Anderson14cacb02021-12-22 12:11:11 -0500347 * clk_get_by_name_nodev_optional - Get/request an optinonal clock by name
348 * without a device.
349 * @node: The client ofnode.
Sean Anderson14cacb02021-12-22 12:11:11 -0500350 * @name: The name of the clock to request, within the client's list of
351 * clocks.
Sean Anderson9c88b132021-12-22 12:11:12 -0500352 * @clk: A pointer to a clock struct to initialize.
Sean Anderson14cacb02021-12-22 12:11:11 -0500353 *
354 * Behaves the same as clk_get_by_name_nodev() except where there is
Sean Anderson9c88b132021-12-22 12:11:12 -0500355 * no clock producer, in this case, skip the error number -%ENODATA, and
Sean Anderson14cacb02021-12-22 12:11:11 -0500356 * the function returns 0.
357 */
358static inline int clk_get_by_name_nodev_optional(ofnode node, const char *name,
359 struct clk *clk)
360{
361 int ret;
362
363 ret = clk_get_by_name_nodev(node, name, clk);
Yang Xiwenc4b52fd2023-08-18 01:04:02 +0800364 if (ret == -ENODATA || ret == -ENOENT)
Sean Anderson14cacb02021-12-22 12:11:11 -0500365 return 0;
366
367 return ret;
368}
369
370/**
Sean Anderson6e33eba2021-06-11 00:16:07 -0400371 * enum clk_defaults_stage - What stage clk_set_defaults() is called at
372 * @CLK_DEFAULTS_PRE: Called before probe. Setting of defaults for clocks owned
373 * by this clock driver will be defered until after probing.
374 * @CLK_DEFAULTS_POST: Called after probe. Only defaults for clocks owned by
375 * this clock driver will be set.
376 * @CLK_DEFAULTS_POST_FORCE: Called after probe, and always set defaults, even
377 * before relocation. Usually, defaults are not set
378 * pre-relocation to avoid setting them twice (when
379 * the device is probed again post-relocation). This
380 * may incur a performance cost as device tree
381 * properties must be parsed for a second time.
382 * However, when not using SPL, pre-relocation may be
383 * the only time we can set defaults for some clocks
384 * (such as those used for the RAM we will relocate
385 * into).
386 */
387enum clk_defaults_stage {
388 CLK_DEFAULTS_PRE = 0,
389 CLK_DEFAULTS_POST = 1,
390 CLK_DEFAULTS_POST_FORCE,
391};
392
Simon Glass414cc152021-08-07 07:24:03 -0600393#if CONFIG_IS_ENABLED(OF_REAL) && CONFIG_IS_ENABLED(CLK)
Philipp Tomsichf4fcba52018-01-08 13:59:18 +0100394/**
Sean Anderson9c88b132021-12-22 12:11:12 -0500395 * clk_set_defaults - Process ``assigned-{clocks/clock-parents/clock-rates}``
Philipp Tomsichf4fcba52018-01-08 13:59:18 +0100396 * properties to configure clocks
Philipp Tomsichf4fcba52018-01-08 13:59:18 +0100397 * @dev: A device to process (the ofnode associated with this device
398 * will be processed).
Sean Anderson6e33eba2021-06-11 00:16:07 -0400399 * @stage: The stage of the probing process this function is called during.
Sean Anderson9c88b132021-12-22 12:11:12 -0500400 *
401 * Return: zero on success, or -ve error code.
Philipp Tomsichf4fcba52018-01-08 13:59:18 +0100402 */
Sean Anderson6e33eba2021-06-11 00:16:07 -0400403int clk_set_defaults(struct udevice *dev, enum clk_defaults_stage stage);
Philipp Tomsichf4fcba52018-01-08 13:59:18 +0100404#else
Jean-Jacques Hiblotfd1ba292019-10-22 14:00:06 +0200405static inline int clk_set_defaults(struct udevice *dev, int stage)
Philipp Tomsichf4fcba52018-01-08 13:59:18 +0100406{
407 return 0;
408}
409#endif
410
Stephen Warren135aa952016-06-17 09:44:00 -0600411/**
Neil Armstronga855be82018-04-03 11:44:18 +0200412 * clk_release_bulk() - Disable (turn off)/Free an array of previously
413 * requested clocks in a clock bulk struct.
Sean Anderson9c88b132021-12-22 12:11:12 -0500414 * @bulk: A clock bulk struct that was previously successfully
415 * requested by clk_get_bulk().
Neil Armstronga855be82018-04-03 11:44:18 +0200416 *
417 * For each clock contained in the clock bulk struct, this function will check
418 * if clock has been previously requested and then will disable and free it.
419 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100420 * Return: zero on success, or -ve error code.
Neil Armstronga855be82018-04-03 11:44:18 +0200421 */
422static inline int clk_release_bulk(struct clk_bulk *bulk)
423{
424 return clk_release_all(bulk->clks, bulk->count);
425}
426
Patrick Delaunay6f791742020-04-27 15:29:57 +0200427#if CONFIG_IS_ENABLED(CLK)
Neil Armstronga855be82018-04-03 11:44:18 +0200428/**
Sean Anderson9c88b132021-12-22 12:11:12 -0500429 * clk_request() - Request a clock by provider-specific ID.
430 * @dev: The clock provider device.
431 * @clk: A pointer to a clock struct to initialize. The caller must
432 * have already initialized any field in this struct which the
433 * clock provider uses to identify the clock.
Stephen Warren135aa952016-06-17 09:44:00 -0600434 *
435 * This requests a clock using a provider-specific ID. Generally, this function
436 * should not be used, since clk_get_by_index/name() provide an interface that
437 * better separates clients from intimate knowledge of clock providers.
438 * However, this function may be useful in core SoC-specific code.
439 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100440 * Return: 0 if OK, or a negative error code.
Stephen Warren135aa952016-06-17 09:44:00 -0600441 */
442int clk_request(struct udevice *dev, struct clk *clk);
443
444/**
Sean Anderson9c88b132021-12-22 12:11:12 -0500445 * clk_free() - Free a previously requested clock.
446 * @clk: A clock struct that was previously successfully requested by
Stephen Warren135aa952016-06-17 09:44:00 -0600447 * clk_request/get_by_*().
Sean Anderson9c88b132021-12-22 12:11:12 -0500448 *
Sean Andersonac15e782022-01-15 17:25:04 -0500449 * Free resources allocated by clk_request() (or any clk_get_* function).
Stephen Warren135aa952016-06-17 09:44:00 -0600450 */
Sean Andersonac15e782022-01-15 17:25:04 -0500451void clk_free(struct clk *clk);
Stephen Warren135aa952016-06-17 09:44:00 -0600452
453/**
454 * clk_get_rate() - Get current clock rate.
Stephen Warren135aa952016-06-17 09:44:00 -0600455 * @clk: A clock struct that was previously successfully requested by
456 * clk_request/get_by_*().
Sean Anderson9c88b132021-12-22 12:11:12 -0500457 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100458 * Return: clock rate in Hz on success, 0 for invalid clock, or -ve error code
Giulio Benetti9e578f62021-02-14 03:17:18 +0100459 * for other errors.
Stephen Warren135aa952016-06-17 09:44:00 -0600460 */
461ulong clk_get_rate(struct clk *clk);
462
463/**
Lukasz Majewski0c660c22019-06-24 15:50:42 +0200464 * clk_get_parent() - Get current clock's parent.
Lukasz Majewski0c660c22019-06-24 15:50:42 +0200465 * @clk: A clock struct that was previously successfully requested by
466 * clk_request/get_by_*().
Sean Anderson9c88b132021-12-22 12:11:12 -0500467 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100468 * Return: pointer to parent's struct clk, or error code passed as pointer
Lukasz Majewski0c660c22019-06-24 15:50:42 +0200469 */
470struct clk *clk_get_parent(struct clk *clk);
471
472/**
Lukasz Majewski4aa78302019-06-24 15:50:43 +0200473 * clk_get_parent_rate() - Get parent of current clock rate.
Lukasz Majewski4aa78302019-06-24 15:50:43 +0200474 * @clk: A clock struct that was previously successfully requested by
475 * clk_request/get_by_*().
Sean Anderson9c88b132021-12-22 12:11:12 -0500476 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100477 * Return: clock rate in Hz, or -ve error code.
Lukasz Majewski4aa78302019-06-24 15:50:43 +0200478 */
Michal Suchaneka1265cd2022-09-28 12:37:57 +0200479ulong clk_get_parent_rate(struct clk *clk);
Lukasz Majewski4aa78302019-06-24 15:50:43 +0200480
481/**
Dario Binacchi2983ad52020-12-30 00:06:31 +0100482 * clk_round_rate() - Adjust a rate to the exact rate a clock can provide
Sean Anderson9c88b132021-12-22 12:11:12 -0500483 * @clk: A clock struct that was previously successfully requested by
484 * clk_request/get_by_*().
485 * @rate: desired clock rate in Hz.
Dario Binacchi2983ad52020-12-30 00:06:31 +0100486 *
487 * This answers the question "if I were to pass @rate to clk_set_rate(),
488 * what clock rate would I end up with?" without changing the hardware
Sean Anderson9c88b132021-12-22 12:11:12 -0500489 * in any way. In other words::
Dario Binacchi2983ad52020-12-30 00:06:31 +0100490 *
491 * rate = clk_round_rate(clk, r);
492 *
Sean Anderson9c88b132021-12-22 12:11:12 -0500493 * and::
Dario Binacchi2983ad52020-12-30 00:06:31 +0100494 *
495 * rate = clk_set_rate(clk, r);
496 *
497 * are equivalent except the former does not modify the clock hardware
498 * in any way.
499 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100500 * Return: rounded rate in Hz, or -ve error code.
Dario Binacchi2983ad52020-12-30 00:06:31 +0100501 */
502ulong clk_round_rate(struct clk *clk, ulong rate);
503
504/**
Stephen Warren135aa952016-06-17 09:44:00 -0600505 * clk_set_rate() - Set current clock rate.
Stephen Warren135aa952016-06-17 09:44:00 -0600506 * @clk: A clock struct that was previously successfully requested by
507 * clk_request/get_by_*().
508 * @rate: New clock rate in Hz.
Sean Anderson9c88b132021-12-22 12:11:12 -0500509 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100510 * Return: new rate, or -ve error code.
Stephen Warren135aa952016-06-17 09:44:00 -0600511 */
512ulong clk_set_rate(struct clk *clk, ulong rate);
513
514/**
Philipp Tomsichf7d10462018-01-08 11:15:08 +0100515 * clk_set_parent() - Set current clock parent.
Philipp Tomsichf7d10462018-01-08 11:15:08 +0100516 * @clk: A clock struct that was previously successfully requested by
517 * clk_request/get_by_*().
518 * @parent: A clock struct that was previously successfully requested by
519 * clk_request/get_by_*().
Sean Anderson9c88b132021-12-22 12:11:12 -0500520 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100521 * Return: new rate, or -ve error code.
Philipp Tomsichf7d10462018-01-08 11:15:08 +0100522 */
523int clk_set_parent(struct clk *clk, struct clk *parent);
524
525/**
Stephen Warren135aa952016-06-17 09:44:00 -0600526 * clk_enable() - Enable (turn on) a clock.
Stephen Warren135aa952016-06-17 09:44:00 -0600527 * @clk: A clock struct that was previously successfully requested by
528 * clk_request/get_by_*().
Sean Anderson9c88b132021-12-22 12:11:12 -0500529 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100530 * Return: zero on success, or -ve error code.
Stephen Warren135aa952016-06-17 09:44:00 -0600531 */
532int clk_enable(struct clk *clk);
533
534/**
Neil Armstronga855be82018-04-03 11:44:18 +0200535 * clk_enable_bulk() - Enable (turn on) all clocks in a clock bulk struct.
Neil Armstronga855be82018-04-03 11:44:18 +0200536 * @bulk: A clock bulk struct that was previously successfully requested
537 * by clk_get_bulk().
Sean Anderson9c88b132021-12-22 12:11:12 -0500538 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100539 * Return: zero on success, or -ve error code.
Neil Armstronga855be82018-04-03 11:44:18 +0200540 */
541int clk_enable_bulk(struct clk_bulk *bulk);
542
543/**
Stephen Warren135aa952016-06-17 09:44:00 -0600544 * clk_disable() - Disable (turn off) a clock.
Stephen Warren135aa952016-06-17 09:44:00 -0600545 * @clk: A clock struct that was previously successfully requested by
546 * clk_request/get_by_*().
Sean Anderson9c88b132021-12-22 12:11:12 -0500547 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100548 * Return: zero on success, or -ve error code.
Stephen Warren135aa952016-06-17 09:44:00 -0600549 */
550int clk_disable(struct clk *clk);
551
Neil Armstronga855be82018-04-03 11:44:18 +0200552/**
553 * clk_disable_bulk() - Disable (turn off) all clocks in a clock bulk struct.
Neil Armstronga855be82018-04-03 11:44:18 +0200554 * @bulk: A clock bulk struct that was previously successfully requested
555 * by clk_get_bulk().
Sean Anderson9c88b132021-12-22 12:11:12 -0500556 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100557 * Return: zero on success, or -ve error code.
Neil Armstronga855be82018-04-03 11:44:18 +0200558 */
559int clk_disable_bulk(struct clk_bulk *bulk);
560
Sekhar Noriacbb7cd2019-08-01 19:12:55 +0530561/**
562 * clk_is_match - check if two clk's point to the same hardware clock
563 * @p: clk compared against q
564 * @q: clk compared against p
565 *
Sean Anderson9c88b132021-12-22 12:11:12 -0500566 * Return:
567 * %true if the two struct clk pointers both point to the same hardware clock
568 * node, and %false otherwise. Note that two %NULL clks are treated as matching.
Sekhar Noriacbb7cd2019-08-01 19:12:55 +0530569 */
570bool clk_is_match(const struct clk *p, const struct clk *q);
571
Lukasz Majewski2796af72019-06-24 15:50:44 +0200572/**
573 * clk_get_by_id() - Get the clock by its ID
Lukasz Majewski2796af72019-06-24 15:50:44 +0200574 * @id: The clock ID to search for
Lukasz Majewski2796af72019-06-24 15:50:44 +0200575 * @clkp: A pointer to clock struct that has been found among added clocks
576 * to UCLASS_CLK
Sean Anderson9c88b132021-12-22 12:11:12 -0500577 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100578 * Return: zero on success, or -ENOENT on error
Lukasz Majewski2796af72019-06-24 15:50:44 +0200579 */
580int clk_get_by_id(ulong id, struct clk **clkp);
Peng Fan24576122019-07-31 07:01:23 +0000581
582/**
583 * clk_dev_binded() - Check whether the clk has a device binded
Sean Anderson9c88b132021-12-22 12:11:12 -0500584 * @clk: A pointer to the clk
Peng Fan24576122019-07-31 07:01:23 +0000585 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100586 * Return: true on binded, or false on no
Peng Fan24576122019-07-31 07:01:23 +0000587 */
588bool clk_dev_binded(struct clk *clk);
Patrick Delaunay6f791742020-04-27 15:29:57 +0200589
590#else /* CONFIG_IS_ENABLED(CLK) */
591
592static inline int clk_request(struct udevice *dev, struct clk *clk)
593{
594 return -ENOSYS;
595}
596
Sean Andersonac15e782022-01-15 17:25:04 -0500597static inline void clk_free(struct clk *clk)
Patrick Delaunay6f791742020-04-27 15:29:57 +0200598{
Sean Andersonac15e782022-01-15 17:25:04 -0500599 return;
Patrick Delaunay6f791742020-04-27 15:29:57 +0200600}
601
602static inline ulong clk_get_rate(struct clk *clk)
603{
604 return -ENOSYS;
605}
606
607static inline struct clk *clk_get_parent(struct clk *clk)
608{
609 return ERR_PTR(-ENOSYS);
610}
611
Michal Suchaneka1265cd2022-09-28 12:37:57 +0200612static inline ulong clk_get_parent_rate(struct clk *clk)
Patrick Delaunay6f791742020-04-27 15:29:57 +0200613{
614 return -ENOSYS;
615}
616
Dario Binacchi2983ad52020-12-30 00:06:31 +0100617static inline ulong clk_round_rate(struct clk *clk, ulong rate)
618{
619 return -ENOSYS;
620}
621
Patrick Delaunay6f791742020-04-27 15:29:57 +0200622static inline ulong clk_set_rate(struct clk *clk, ulong rate)
623{
624 return -ENOSYS;
625}
626
627static inline int clk_set_parent(struct clk *clk, struct clk *parent)
628{
629 return -ENOSYS;
630}
631
632static inline int clk_enable(struct clk *clk)
633{
634 return 0;
635}
636
637static inline int clk_enable_bulk(struct clk_bulk *bulk)
638{
639 return 0;
640}
641
642static inline int clk_disable(struct clk *clk)
643{
644 return 0;
645}
646
647static inline int clk_disable_bulk(struct clk_bulk *bulk)
648{
649 return 0;
650}
651
652static inline bool clk_is_match(const struct clk *p, const struct clk *q)
653{
654 return false;
655}
656
657static inline int clk_get_by_id(ulong id, struct clk **clkp)
658{
659 return -ENOSYS;
660}
661
662static inline bool clk_dev_binded(struct clk *clk)
663{
664 return false;
665}
666#endif /* CONFIG_IS_ENABLED(CLK) */
667
668/**
669 * clk_valid() - check if clk is valid
Patrick Delaunay6f791742020-04-27 15:29:57 +0200670 * @clk: the clock to check
Sean Anderson9c88b132021-12-22 12:11:12 -0500671 *
Heinrich Schuchardt185f8122022-01-19 18:05:50 +0100672 * Return: true if valid, or false
Patrick Delaunay6f791742020-04-27 15:29:57 +0200673 */
674static inline bool clk_valid(struct clk *clk)
675{
676 return clk && !!clk->dev;
677}
678
679int soc_clk_dump(void);
680
Stephen Warren135aa952016-06-17 09:44:00 -0600681#endif
Jean-Jacques Hiblot52720c52019-10-22 14:00:04 +0200682
683#define clk_prepare_enable(clk) clk_enable(clk)
684#define clk_disable_unprepare(clk) clk_disable(clk)