Linux Audio

Check our new training course

Loading...
v6.8
  1// SPDX-License-Identifier: GPL-2.0-only
  2/*
  3 * drivers/clk/clkdev.c
  4 *
  5 *  Copyright (C) 2008 Russell King.
  6 *
 
 
 
 
  7 * Helper for the clk API to assist looking up a struct clk.
  8 */
  9#include <linux/module.h>
 10#include <linux/kernel.h>
 11#include <linux/device.h>
 12#include <linux/list.h>
 13#include <linux/errno.h>
 14#include <linux/err.h>
 15#include <linux/string.h>
 16#include <linux/mutex.h>
 17#include <linux/clk.h>
 18#include <linux/clkdev.h>
 19#include <linux/clk-provider.h>
 20#include <linux/of.h>
 21
 22#include "clk.h"
 23
 24static LIST_HEAD(clocks);
 25static DEFINE_MUTEX(clocks_mutex);
 26
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 27/*
 28 * Find the correct struct clk for the device and connection ID.
 29 * We do slightly fuzzy matching here:
 30 *  An entry with a NULL ID is assumed to be a wildcard.
 31 *  If an entry has a device ID, it must match
 32 *  If an entry has a connection ID, it must match
 33 * Then we take the most specific entry - with the following
 34 * order of precedence: dev+con > dev only > con only.
 35 */
 36static struct clk_lookup *clk_find(const char *dev_id, const char *con_id)
 37{
 38	struct clk_lookup *p, *cl = NULL;
 39	int match, best_found = 0, best_possible = 0;
 40
 41	if (dev_id)
 42		best_possible += 2;
 43	if (con_id)
 44		best_possible += 1;
 45
 46	lockdep_assert_held(&clocks_mutex);
 47
 48	list_for_each_entry(p, &clocks, node) {
 49		match = 0;
 50		if (p->dev_id) {
 51			if (!dev_id || strcmp(p->dev_id, dev_id))
 52				continue;
 53			match += 2;
 54		}
 55		if (p->con_id) {
 56			if (!con_id || strcmp(p->con_id, con_id))
 57				continue;
 58			match += 1;
 59		}
 60
 61		if (match > best_found) {
 62			cl = p;
 63			if (match != best_possible)
 64				best_found = match;
 65			else
 66				break;
 67		}
 68	}
 69	return cl;
 70}
 71
 72struct clk_hw *clk_find_hw(const char *dev_id, const char *con_id)
 73{
 74	struct clk_lookup *cl;
 75	struct clk_hw *hw = ERR_PTR(-ENOENT);
 76
 77	mutex_lock(&clocks_mutex);
 
 78	cl = clk_find(dev_id, con_id);
 79	if (cl)
 80		hw = cl->clk_hw;
 81	mutex_unlock(&clocks_mutex);
 82
 83	return hw;
 84}
 
 85
 86static struct clk *__clk_get_sys(struct device *dev, const char *dev_id,
 87				 const char *con_id)
 88{
 89	struct clk_hw *hw = clk_find_hw(dev_id, con_id);
 
 90
 91	return clk_hw_create_clk(dev, hw, dev_id, con_id);
 92}
 93
 94struct clk *clk_get_sys(const char *dev_id, const char *con_id)
 95{
 96	return __clk_get_sys(NULL, dev_id, con_id);
 97}
 98EXPORT_SYMBOL(clk_get_sys);
 99
100struct clk *clk_get(struct device *dev, const char *con_id)
101{
102	const char *dev_id = dev ? dev_name(dev) : NULL;
103	struct clk_hw *hw;
104
105	if (dev && dev->of_node) {
106		hw = of_clk_get_hw(dev->of_node, 0, con_id);
107		if (!IS_ERR(hw) || PTR_ERR(hw) == -EPROBE_DEFER)
108			return clk_hw_create_clk(dev, hw, dev_id, con_id);
109	}
110
111	return __clk_get_sys(dev, dev_id, con_id);
112}
113EXPORT_SYMBOL(clk_get);
114
115void clk_put(struct clk *clk)
116{
117	__clk_put(clk);
118}
119EXPORT_SYMBOL(clk_put);
120
121static void __clkdev_add(struct clk_lookup *cl)
122{
123	mutex_lock(&clocks_mutex);
124	list_add_tail(&cl->node, &clocks);
125	mutex_unlock(&clocks_mutex);
126}
127
128void clkdev_add(struct clk_lookup *cl)
129{
130	if (!cl->clk_hw)
131		cl->clk_hw = __clk_get_hw(cl->clk);
132	__clkdev_add(cl);
133}
134EXPORT_SYMBOL(clkdev_add);
135
136void clkdev_add_table(struct clk_lookup *cl, size_t num)
137{
138	mutex_lock(&clocks_mutex);
139	while (num--) {
140		cl->clk_hw = __clk_get_hw(cl->clk);
141		list_add_tail(&cl->node, &clocks);
142		cl++;
143	}
144	mutex_unlock(&clocks_mutex);
145}
146
147#define MAX_DEV_ID	20
148#define MAX_CON_ID	16
149
150struct clk_lookup_alloc {
151	struct clk_lookup cl;
152	char	dev_id[MAX_DEV_ID];
153	char	con_id[MAX_CON_ID];
154};
155
156static struct clk_lookup * __ref
157vclkdev_alloc(struct clk_hw *hw, const char *con_id, const char *dev_fmt,
158	va_list ap)
159{
160	struct clk_lookup_alloc *cla;
161
162	cla = kzalloc(sizeof(*cla), GFP_KERNEL);
163	if (!cla)
164		return NULL;
165
166	cla->cl.clk_hw = hw;
167	if (con_id) {
168		strscpy(cla->con_id, con_id, sizeof(cla->con_id));
169		cla->cl.con_id = cla->con_id;
170	}
171
172	if (dev_fmt) {
173		vscnprintf(cla->dev_id, sizeof(cla->dev_id), dev_fmt, ap);
174		cla->cl.dev_id = cla->dev_id;
175	}
176
177	return &cla->cl;
178}
179
180static struct clk_lookup *
181vclkdev_create(struct clk_hw *hw, const char *con_id, const char *dev_fmt,
182	va_list ap)
183{
184	struct clk_lookup *cl;
185
186	cl = vclkdev_alloc(hw, con_id, dev_fmt, ap);
187	if (cl)
188		__clkdev_add(cl);
189
190	return cl;
191}
192
193/**
194 * clkdev_create - allocate and add a clkdev lookup structure
195 * @clk: struct clk to associate with all clk_lookups
196 * @con_id: connection ID string on device
197 * @dev_fmt: format string describing device name
198 *
199 * Returns a clk_lookup structure, which can be later unregistered and
200 * freed.
201 */
202struct clk_lookup *clkdev_create(struct clk *clk, const char *con_id,
203	const char *dev_fmt, ...)
204{
205	struct clk_lookup *cl;
206	va_list ap;
207
208	va_start(ap, dev_fmt);
209	cl = vclkdev_create(__clk_get_hw(clk), con_id, dev_fmt, ap);
210	va_end(ap);
211
212	return cl;
213}
214EXPORT_SYMBOL_GPL(clkdev_create);
215
216/**
217 * clkdev_hw_create - allocate and add a clkdev lookup structure
218 * @hw: struct clk_hw to associate with all clk_lookups
219 * @con_id: connection ID string on device
220 * @dev_fmt: format string describing device name
221 *
222 * Returns a clk_lookup structure, which can be later unregistered and
223 * freed.
224 */
225struct clk_lookup *clkdev_hw_create(struct clk_hw *hw, const char *con_id,
226	const char *dev_fmt, ...)
227{
228	struct clk_lookup *cl;
229	va_list ap;
230
231	va_start(ap, dev_fmt);
232	cl = vclkdev_create(hw, con_id, dev_fmt, ap);
233	va_end(ap);
234
235	return cl;
236}
237EXPORT_SYMBOL_GPL(clkdev_hw_create);
238
239int clk_add_alias(const char *alias, const char *alias_dev_name,
240	const char *con_id, struct device *dev)
241{
242	struct clk *r = clk_get(dev, con_id);
243	struct clk_lookup *l;
244
245	if (IS_ERR(r))
246		return PTR_ERR(r);
247
248	l = clkdev_create(r, alias, alias_dev_name ? "%s" : NULL,
249			  alias_dev_name);
250	clk_put(r);
251
252	return l ? 0 : -ENODEV;
253}
254EXPORT_SYMBOL(clk_add_alias);
255
256/*
257 * clkdev_drop - remove a clock dynamically allocated
258 */
259void clkdev_drop(struct clk_lookup *cl)
260{
261	mutex_lock(&clocks_mutex);
262	list_del(&cl->node);
263	mutex_unlock(&clocks_mutex);
264	kfree(cl);
265}
266EXPORT_SYMBOL(clkdev_drop);
267
268static struct clk_lookup *__clk_register_clkdev(struct clk_hw *hw,
269						const char *con_id,
270						const char *dev_id, ...)
271{
272	struct clk_lookup *cl;
273	va_list ap;
274
275	va_start(ap, dev_id);
276	cl = vclkdev_create(hw, con_id, dev_id, ap);
277	va_end(ap);
278
279	return cl;
280}
281
282static int do_clk_register_clkdev(struct clk_hw *hw,
283	struct clk_lookup **cl, const char *con_id, const char *dev_id)
284{
285	if (IS_ERR(hw))
286		return PTR_ERR(hw);
287	/*
288	 * Since dev_id can be NULL, and NULL is handled specially, we must
289	 * pass it as either a NULL format string, or with "%s".
290	 */
291	if (dev_id)
292		*cl = __clk_register_clkdev(hw, con_id, "%s", dev_id);
293	else
294		*cl = __clk_register_clkdev(hw, con_id, NULL);
295
296	return *cl ? 0 : -ENOMEM;
297}
298
299/**
300 * clk_register_clkdev - register one clock lookup for a struct clk
301 * @clk: struct clk to associate with all clk_lookups
302 * @con_id: connection ID string on device
303 * @dev_id: string describing device name
304 *
305 * con_id or dev_id may be NULL as a wildcard, just as in the rest of
306 * clkdev.
307 *
308 * To make things easier for mass registration, we detect error clks
309 * from a previous clk_register() call, and return the error code for
310 * those.  This is to permit this function to be called immediately
311 * after clk_register().
312 */
313int clk_register_clkdev(struct clk *clk, const char *con_id,
314	const char *dev_id)
315{
316	struct clk_lookup *cl;
317
318	if (IS_ERR(clk))
319		return PTR_ERR(clk);
320
321	return do_clk_register_clkdev(__clk_get_hw(clk), &cl, con_id,
322					      dev_id);
 
 
 
 
 
 
 
 
 
323}
324EXPORT_SYMBOL(clk_register_clkdev);
325
326/**
327 * clk_hw_register_clkdev - register one clock lookup for a struct clk_hw
328 * @hw: struct clk_hw to associate with all clk_lookups
329 * @con_id: connection ID string on device
330 * @dev_id: format string describing device name
331 *
332 * con_id or dev_id may be NULL as a wildcard, just as in the rest of
333 * clkdev.
334 *
335 * To make things easier for mass registration, we detect error clk_hws
336 * from a previous clk_hw_register_*() call, and return the error code for
337 * those.  This is to permit this function to be called immediately
338 * after clk_hw_register_*().
339 */
340int clk_hw_register_clkdev(struct clk_hw *hw, const char *con_id,
341	const char *dev_id)
342{
343	struct clk_lookup *cl;
344
345	return do_clk_register_clkdev(hw, &cl, con_id, dev_id);
346}
347EXPORT_SYMBOL(clk_hw_register_clkdev);
348
349static void devm_clkdev_release(void *res)
350{
351	clkdev_drop(res);
352}
353
354/**
355 * devm_clk_hw_register_clkdev - managed clk lookup registration for clk_hw
356 * @dev: device this lookup is bound
357 * @hw: struct clk_hw to associate with all clk_lookups
358 * @con_id: connection ID string on device
359 * @dev_id: format string describing device name
360 *
361 * con_id or dev_id may be NULL as a wildcard, just as in the rest of
362 * clkdev.
363 *
364 * To make things easier for mass registration, we detect error clk_hws
365 * from a previous clk_hw_register_*() call, and return the error code for
366 * those.  This is to permit this function to be called immediately
367 * after clk_hw_register_*().
368 */
369int devm_clk_hw_register_clkdev(struct device *dev, struct clk_hw *hw,
370				const char *con_id, const char *dev_id)
371{
372	struct clk_lookup *cl;
373	int rval;
374
375	rval = do_clk_register_clkdev(hw, &cl, con_id, dev_id);
376	if (rval)
377		return rval;
 
378
379	return devm_add_action_or_reset(dev, devm_clkdev_release, cl);
380}
381EXPORT_SYMBOL(devm_clk_hw_register_clkdev);
v4.6
 
  1/*
  2 * drivers/clk/clkdev.c
  3 *
  4 *  Copyright (C) 2008 Russell King.
  5 *
  6 * This program is free software; you can redistribute it and/or modify
  7 * it under the terms of the GNU General Public License version 2 as
  8 * published by the Free Software Foundation.
  9 *
 10 * Helper for the clk API to assist looking up a struct clk.
 11 */
 12#include <linux/module.h>
 13#include <linux/kernel.h>
 14#include <linux/device.h>
 15#include <linux/list.h>
 16#include <linux/errno.h>
 17#include <linux/err.h>
 18#include <linux/string.h>
 19#include <linux/mutex.h>
 20#include <linux/clk.h>
 21#include <linux/clkdev.h>
 22#include <linux/clk-provider.h>
 23#include <linux/of.h>
 24
 25#include "clk.h"
 26
 27static LIST_HEAD(clocks);
 28static DEFINE_MUTEX(clocks_mutex);
 29
 30#if defined(CONFIG_OF) && defined(CONFIG_COMMON_CLK)
 31static struct clk *__of_clk_get(struct device_node *np, int index,
 32			       const char *dev_id, const char *con_id)
 33{
 34	struct of_phandle_args clkspec;
 35	struct clk *clk;
 36	int rc;
 37
 38	if (index < 0)
 39		return ERR_PTR(-EINVAL);
 40
 41	rc = of_parse_phandle_with_args(np, "clocks", "#clock-cells", index,
 42					&clkspec);
 43	if (rc)
 44		return ERR_PTR(rc);
 45
 46	clk = __of_clk_get_from_provider(&clkspec, dev_id, con_id);
 47	of_node_put(clkspec.np);
 48
 49	return clk;
 50}
 51
 52struct clk *of_clk_get(struct device_node *np, int index)
 53{
 54	return __of_clk_get(np, index, np->full_name, NULL);
 55}
 56EXPORT_SYMBOL(of_clk_get);
 57
 58static struct clk *__of_clk_get_by_name(struct device_node *np,
 59					const char *dev_id,
 60					const char *name)
 61{
 62	struct clk *clk = ERR_PTR(-ENOENT);
 63
 64	/* Walk up the tree of devices looking for a clock that matches */
 65	while (np) {
 66		int index = 0;
 67
 68		/*
 69		 * For named clocks, first look up the name in the
 70		 * "clock-names" property.  If it cannot be found, then
 71		 * index will be an error code, and of_clk_get() will fail.
 72		 */
 73		if (name)
 74			index = of_property_match_string(np, "clock-names", name);
 75		clk = __of_clk_get(np, index, dev_id, name);
 76		if (!IS_ERR(clk)) {
 77			break;
 78		} else if (name && index >= 0) {
 79			if (PTR_ERR(clk) != -EPROBE_DEFER)
 80				pr_err("ERROR: could not get clock %s:%s(%i)\n",
 81					np->full_name, name ? name : "", index);
 82			return clk;
 83		}
 84
 85		/*
 86		 * No matching clock found on this node.  If the parent node
 87		 * has a "clock-ranges" property, then we can try one of its
 88		 * clocks.
 89		 */
 90		np = np->parent;
 91		if (np && !of_get_property(np, "clock-ranges", NULL))
 92			break;
 93	}
 94
 95	return clk;
 96}
 97
 98/**
 99 * of_clk_get_by_name() - Parse and lookup a clock referenced by a device node
100 * @np: pointer to clock consumer node
101 * @name: name of consumer's clock input, or NULL for the first clock reference
102 *
103 * This function parses the clocks and clock-names properties,
104 * and uses them to look up the struct clk from the registered list of clock
105 * providers.
106 */
107struct clk *of_clk_get_by_name(struct device_node *np, const char *name)
108{
109	if (!np)
110		return ERR_PTR(-ENOENT);
111
112	return __of_clk_get_by_name(np, np->full_name, name);
113}
114EXPORT_SYMBOL(of_clk_get_by_name);
115
116#else /* defined(CONFIG_OF) && defined(CONFIG_COMMON_CLK) */
117
118static struct clk *__of_clk_get_by_name(struct device_node *np,
119					const char *dev_id,
120					const char *name)
121{
122	return ERR_PTR(-ENOENT);
123}
124#endif
125
126/*
127 * Find the correct struct clk for the device and connection ID.
128 * We do slightly fuzzy matching here:
129 *  An entry with a NULL ID is assumed to be a wildcard.
130 *  If an entry has a device ID, it must match
131 *  If an entry has a connection ID, it must match
132 * Then we take the most specific entry - with the following
133 * order of precedence: dev+con > dev only > con only.
134 */
135static struct clk_lookup *clk_find(const char *dev_id, const char *con_id)
136{
137	struct clk_lookup *p, *cl = NULL;
138	int match, best_found = 0, best_possible = 0;
139
140	if (dev_id)
141		best_possible += 2;
142	if (con_id)
143		best_possible += 1;
144
 
 
145	list_for_each_entry(p, &clocks, node) {
146		match = 0;
147		if (p->dev_id) {
148			if (!dev_id || strcmp(p->dev_id, dev_id))
149				continue;
150			match += 2;
151		}
152		if (p->con_id) {
153			if (!con_id || strcmp(p->con_id, con_id))
154				continue;
155			match += 1;
156		}
157
158		if (match > best_found) {
159			cl = p;
160			if (match != best_possible)
161				best_found = match;
162			else
163				break;
164		}
165	}
166	return cl;
167}
168
169struct clk *clk_get_sys(const char *dev_id, const char *con_id)
170{
171	struct clk_lookup *cl;
172	struct clk *clk = NULL;
173
174	mutex_lock(&clocks_mutex);
175
176	cl = clk_find(dev_id, con_id);
177	if (!cl)
178		goto out;
 
179
180	clk = __clk_create_clk(cl->clk_hw, dev_id, con_id);
181	if (IS_ERR(clk))
182		goto out;
183
184	if (!__clk_get(clk)) {
185		__clk_free_clk(clk);
186		cl = NULL;
187		goto out;
188	}
189
190out:
191	mutex_unlock(&clocks_mutex);
192
193	return cl ? clk : ERR_PTR(-ENOENT);
 
 
194}
195EXPORT_SYMBOL(clk_get_sys);
196
197struct clk *clk_get(struct device *dev, const char *con_id)
198{
199	const char *dev_id = dev ? dev_name(dev) : NULL;
200	struct clk *clk;
201
202	if (dev) {
203		clk = __of_clk_get_by_name(dev->of_node, dev_id, con_id);
204		if (!IS_ERR(clk) || PTR_ERR(clk) == -EPROBE_DEFER)
205			return clk;
206	}
207
208	return clk_get_sys(dev_id, con_id);
209}
210EXPORT_SYMBOL(clk_get);
211
212void clk_put(struct clk *clk)
213{
214	__clk_put(clk);
215}
216EXPORT_SYMBOL(clk_put);
217
218static void __clkdev_add(struct clk_lookup *cl)
219{
220	mutex_lock(&clocks_mutex);
221	list_add_tail(&cl->node, &clocks);
222	mutex_unlock(&clocks_mutex);
223}
224
225void clkdev_add(struct clk_lookup *cl)
226{
227	if (!cl->clk_hw)
228		cl->clk_hw = __clk_get_hw(cl->clk);
229	__clkdev_add(cl);
230}
231EXPORT_SYMBOL(clkdev_add);
232
233void clkdev_add_table(struct clk_lookup *cl, size_t num)
234{
235	mutex_lock(&clocks_mutex);
236	while (num--) {
237		cl->clk_hw = __clk_get_hw(cl->clk);
238		list_add_tail(&cl->node, &clocks);
239		cl++;
240	}
241	mutex_unlock(&clocks_mutex);
242}
243
244#define MAX_DEV_ID	20
245#define MAX_CON_ID	16
246
247struct clk_lookup_alloc {
248	struct clk_lookup cl;
249	char	dev_id[MAX_DEV_ID];
250	char	con_id[MAX_CON_ID];
251};
252
253static struct clk_lookup * __init_refok
254vclkdev_alloc(struct clk_hw *hw, const char *con_id, const char *dev_fmt,
255	va_list ap)
256{
257	struct clk_lookup_alloc *cla;
258
259	cla = __clkdev_alloc(sizeof(*cla));
260	if (!cla)
261		return NULL;
262
263	cla->cl.clk_hw = hw;
264	if (con_id) {
265		strlcpy(cla->con_id, con_id, sizeof(cla->con_id));
266		cla->cl.con_id = cla->con_id;
267	}
268
269	if (dev_fmt) {
270		vscnprintf(cla->dev_id, sizeof(cla->dev_id), dev_fmt, ap);
271		cla->cl.dev_id = cla->dev_id;
272	}
273
274	return &cla->cl;
275}
276
277static struct clk_lookup *
278vclkdev_create(struct clk_hw *hw, const char *con_id, const char *dev_fmt,
279	va_list ap)
280{
281	struct clk_lookup *cl;
282
283	cl = vclkdev_alloc(hw, con_id, dev_fmt, ap);
284	if (cl)
285		__clkdev_add(cl);
286
287	return cl;
288}
289
290struct clk_lookup * __init_refok
291clkdev_alloc(struct clk *clk, const char *con_id, const char *dev_fmt, ...)
 
 
 
 
 
 
 
 
 
292{
293	struct clk_lookup *cl;
294	va_list ap;
295
296	va_start(ap, dev_fmt);
297	cl = vclkdev_alloc(__clk_get_hw(clk), con_id, dev_fmt, ap);
298	va_end(ap);
299
300	return cl;
301}
302EXPORT_SYMBOL(clkdev_alloc);
303
304/**
305 * clkdev_create - allocate and add a clkdev lookup structure
306 * @clk: struct clk to associate with all clk_lookups
307 * @con_id: connection ID string on device
308 * @dev_fmt: format string describing device name
309 *
310 * Returns a clk_lookup structure, which can be later unregistered and
311 * freed.
312 */
313struct clk_lookup *clkdev_create(struct clk *clk, const char *con_id,
314	const char *dev_fmt, ...)
315{
316	struct clk_lookup *cl;
317	va_list ap;
318
319	va_start(ap, dev_fmt);
320	cl = vclkdev_create(__clk_get_hw(clk), con_id, dev_fmt, ap);
321	va_end(ap);
322
323	return cl;
324}
325EXPORT_SYMBOL_GPL(clkdev_create);
326
327int clk_add_alias(const char *alias, const char *alias_dev_name,
328	const char *con_id, struct device *dev)
329{
330	struct clk *r = clk_get(dev, con_id);
331	struct clk_lookup *l;
332
333	if (IS_ERR(r))
334		return PTR_ERR(r);
335
336	l = clkdev_create(r, alias, alias_dev_name ? "%s" : NULL,
337			  alias_dev_name);
338	clk_put(r);
339
340	return l ? 0 : -ENODEV;
341}
342EXPORT_SYMBOL(clk_add_alias);
343
344/*
345 * clkdev_drop - remove a clock dynamically allocated
346 */
347void clkdev_drop(struct clk_lookup *cl)
348{
349	mutex_lock(&clocks_mutex);
350	list_del(&cl->node);
351	mutex_unlock(&clocks_mutex);
352	kfree(cl);
353}
354EXPORT_SYMBOL(clkdev_drop);
355
356static struct clk_lookup *__clk_register_clkdev(struct clk_hw *hw,
357						const char *con_id,
358						const char *dev_id, ...)
359{
360	struct clk_lookup *cl;
361	va_list ap;
362
363	va_start(ap, dev_id);
364	cl = vclkdev_create(hw, con_id, dev_id, ap);
365	va_end(ap);
366
367	return cl;
368}
369
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
370/**
371 * clk_register_clkdev - register one clock lookup for a struct clk
372 * @clk: struct clk to associate with all clk_lookups
373 * @con_id: connection ID string on device
374 * @dev_id: string describing device name
375 *
376 * con_id or dev_id may be NULL as a wildcard, just as in the rest of
377 * clkdev.
378 *
379 * To make things easier for mass registration, we detect error clks
380 * from a previous clk_register() call, and return the error code for
381 * those.  This is to permit this function to be called immediately
382 * after clk_register().
383 */
384int clk_register_clkdev(struct clk *clk, const char *con_id,
385	const char *dev_id)
386{
387	struct clk_lookup *cl;
388
389	if (IS_ERR(clk))
390		return PTR_ERR(clk);
391
392	/*
393	 * Since dev_id can be NULL, and NULL is handled specially, we must
394	 * pass it as either a NULL format string, or with "%s".
395	 */
396	if (dev_id)
397		cl = __clk_register_clkdev(__clk_get_hw(clk), con_id, "%s",
398					   dev_id);
399	else
400		cl = __clk_register_clkdev(__clk_get_hw(clk), con_id, NULL);
401
402	return cl ? 0 : -ENOMEM;
403}
404EXPORT_SYMBOL(clk_register_clkdev);
405
406/**
407 * clk_register_clkdevs - register a set of clk_lookup for a struct clk
408 * @clk: struct clk to associate with all clk_lookups
409 * @cl: array of clk_lookup structures with con_id and dev_id pre-initialized
410 * @num: number of clk_lookup structures to register
 
 
 
411 *
412 * To make things easier for mass registration, we detect error clks
413 * from a previous clk_register() call, and return the error code for
414 * those.  This is to permit this function to be called immediately
415 * after clk_register().
416 */
417int clk_register_clkdevs(struct clk *clk, struct clk_lookup *cl, size_t num)
 
 
 
 
 
 
 
 
 
418{
419	unsigned i;
 
420
421	if (IS_ERR(clk))
422		return PTR_ERR(clk);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
423
424	for (i = 0; i < num; i++, cl++) {
425		cl->clk_hw = __clk_get_hw(clk);
426		__clkdev_add(cl);
427	}
428
429	return 0;
430}
431EXPORT_SYMBOL(clk_register_clkdevs);