drivers/clk/clkdev.c

   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
  24 static LIST_HEAD(clocks);
  25 static 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  */
  36 static 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
  72 struct 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
  86 static 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
  94 struct clk *clk_get_sys(const char *dev_id, const char *con_id)
  95 {
  96         return __clk_get_sys(NULL, dev_id, con_id);
  97 }
  98 EXPORT_SYMBOL(clk_get_sys);
  99
 100 struct 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 }
 113 EXPORT_SYMBOL(clk_get);
 114
 115 void clk_put(struct clk *clk)
 116 {
 117         __clk_put(clk);
 118 }
 119 EXPORT_SYMBOL(clk_put);
 120
 121 static 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
 128 void 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 }
 134 EXPORT_SYMBOL(clkdev_add);
 135
 136 void 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      24
 148 #define MAX_CON_ID      16
 149
 150 struct clk_lookup_alloc {
 151         struct clk_lookup cl;
 152         char    dev_id[MAX_DEV_ID];
 153         char    con_id[MAX_CON_ID];
 154 };
 155
 156 static struct clk_lookup * __ref
 157 vclkdev_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         struct va_format vaf;
 162         const char *failure;
 163         va_list ap_copy;
 164         size_t max_size;
 165         ssize_t res;
 166
 167         cla = kzalloc(sizeof(*cla), GFP_KERNEL);
 168         if (!cla)
 169                 return NULL;
 170
 171         va_copy(ap_copy, ap);
 172
 173         cla->cl.clk_hw = hw;
 174         if (con_id) {
 175                 res = strscpy(cla->con_id, con_id, sizeof(cla->con_id));
 176                 if (res < 0) {
 177                         max_size = sizeof(cla->con_id);
 178                         failure = "connection";
 179                         goto fail;
 180                 }
 181                 cla->cl.con_id = cla->con_id;
 182         }
 183
 184         if (dev_fmt) {
 185                 res = vsnprintf(cla->dev_id, sizeof(cla->dev_id), dev_fmt, ap);
 186                 if (res >= sizeof(cla->dev_id)) {
 187                         max_size = sizeof(cla->dev_id);
 188                         failure = "device";
 189                         goto fail;
 190                 }
 191                 cla->cl.dev_id = cla->dev_id;
 192         }
 193
 194         va_end(ap_copy);
 195
 196         return &cla->cl;
 197
 198 fail:
 199         if (dev_fmt)
 200                 vaf.fmt = dev_fmt;
 201         else
 202                 vaf.fmt = "null-device";
 203         vaf.va = &ap_copy;
 204         pr_err("%pV:%s: %s ID is greater than %zu\n",
 205                &vaf, con_id, failure, max_size);
 206         va_end(ap_copy);
 207         kfree(cla);
 208         return NULL;
 209 }
 210
 211 static struct clk_lookup *
 212 vclkdev_create(struct clk_hw *hw, const char *con_id, const char *dev_fmt,
 213         va_list ap)
 214 {
 215         struct clk_lookup *cl;
 216
 217         cl = vclkdev_alloc(hw, con_id, dev_fmt, ap);
 218         if (cl)
 219                 __clkdev_add(cl);
 220
 221         return cl;
 222 }
 223
 224 /**
 225  * clkdev_create - allocate and add a clkdev lookup structure
 226  * @clk: struct clk to associate with all clk_lookups
 227  * @con_id: connection ID string on device
 228  * @dev_fmt: format string describing device name
 229  *
 230  * Returns a clk_lookup structure, which can be later unregistered and
 231  * freed.
 232  */
 233 struct clk_lookup *clkdev_create(struct clk *clk, const char *con_id,
 234         const char *dev_fmt, ...)
 235 {
 236         struct clk_lookup *cl;
 237         va_list ap;
 238
 239         va_start(ap, dev_fmt);
 240         cl = vclkdev_create(__clk_get_hw(clk), con_id, dev_fmt, ap);
 241         va_end(ap);
 242
 243         return cl;
 244 }
 245 EXPORT_SYMBOL_GPL(clkdev_create);
 246
 247 /**
 248  * clkdev_hw_create - allocate and add a clkdev lookup structure
 249  * @hw: struct clk_hw to associate with all clk_lookups
 250  * @con_id: connection ID string on device
 251  * @dev_fmt: format string describing device name
 252  *
 253  * Returns a clk_lookup structure, which can be later unregistered and
 254  * freed.
 255  */
 256 struct clk_lookup *clkdev_hw_create(struct clk_hw *hw, const char *con_id,
 257         const char *dev_fmt, ...)
 258 {
 259         struct clk_lookup *cl;
 260         va_list ap;
 261
 262         va_start(ap, dev_fmt);
 263         cl = vclkdev_create(hw, con_id, dev_fmt, ap);
 264         va_end(ap);
 265
 266         return cl;
 267 }
 268 EXPORT_SYMBOL_GPL(clkdev_hw_create);
 269
 270 int clk_add_alias(const char *alias, const char *alias_dev_name,
 271         const char *con_id, struct device *dev)
 272 {
 273         struct clk *r = clk_get(dev, con_id);
 274         struct clk_lookup *l;
 275
 276         if (IS_ERR(r))
 277                 return PTR_ERR(r);
 278
 279         l = clkdev_create(r, alias, alias_dev_name ? "%s" : NULL,
 280                           alias_dev_name);
 281         clk_put(r);
 282
 283         return l ? 0 : -ENODEV;
 284 }
 285 EXPORT_SYMBOL(clk_add_alias);
 286
 287 /*
 288  * clkdev_drop - remove a clock dynamically allocated
 289  */
 290 void clkdev_drop(struct clk_lookup *cl)
 291 {
 292         mutex_lock(&clocks_mutex);
 293         list_del(&cl->node);
 294         mutex_unlock(&clocks_mutex);
 295         kfree(cl);
 296 }
 297 EXPORT_SYMBOL(clkdev_drop);
 298
 299 static struct clk_lookup *__clk_register_clkdev(struct clk_hw *hw,
 300                                                 const char *con_id,
 301                                                 const char *dev_id, ...)
 302 {
 303         struct clk_lookup *cl;
 304         va_list ap;
 305
 306         va_start(ap, dev_id);
 307         cl = vclkdev_create(hw, con_id, dev_id, ap);
 308         va_end(ap);
 309
 310         return cl;
 311 }
 312
 313 static int do_clk_register_clkdev(struct clk_hw *hw,
 314         struct clk_lookup **cl, const char *con_id, const char *dev_id)
 315 {
 316         if (IS_ERR(hw))
 317                 return PTR_ERR(hw);
 318         /*
 319          * Since dev_id can be NULL, and NULL is handled specially, we must
 320          * pass it as either a NULL format string, or with "%s".
 321          */
 322         if (dev_id)
 323                 *cl = __clk_register_clkdev(hw, con_id, "%s", dev_id);
 324         else
 325                 *cl = __clk_register_clkdev(hw, con_id, NULL);
 326
 327         return *cl ? 0 : -ENOMEM;
 328 }
 329
 330 /**
 331  * clk_register_clkdev - register one clock lookup for a struct clk
 332  * @clk: struct clk to associate with all clk_lookups
 333  * @con_id: connection ID string on device
 334  * @dev_id: string describing device name
 335  *
 336  * con_id or dev_id may be NULL as a wildcard, just as in the rest of
 337  * clkdev.
 338  *
 339  * To make things easier for mass registration, we detect error clks
 340  * from a previous clk_register() call, and return the error code for
 341  * those.  This is to permit this function to be called immediately
 342  * after clk_register().
 343  */
 344 int clk_register_clkdev(struct clk *clk, const char *con_id,
 345         const char *dev_id)
 346 {
 347         struct clk_lookup *cl;
 348
 349         if (IS_ERR(clk))
 350                 return PTR_ERR(clk);
 351
 352         return do_clk_register_clkdev(__clk_get_hw(clk), &cl, con_id,
 353                                               dev_id);
 354 }
 355 EXPORT_SYMBOL(clk_register_clkdev);
 356
 357 /**
 358  * clk_hw_register_clkdev - register one clock lookup for a struct clk_hw
 359  * @hw: struct clk_hw to associate with all clk_lookups
 360  * @con_id: connection ID string on device
 361  * @dev_id: format string describing device name
 362  *
 363  * con_id or dev_id may be NULL as a wildcard, just as in the rest of
 364  * clkdev.
 365  *
 366  * To make things easier for mass registration, we detect error clk_hws
 367  * from a previous clk_hw_register_*() call, and return the error code for
 368  * those.  This is to permit this function to be called immediately
 369  * after clk_hw_register_*().
 370  */
 371 int clk_hw_register_clkdev(struct clk_hw *hw, const char *con_id,
 372         const char *dev_id)
 373 {
 374         struct clk_lookup *cl;
 375
 376         return do_clk_register_clkdev(hw, &cl, con_id, dev_id);
 377 }
 378 EXPORT_SYMBOL(clk_hw_register_clkdev);
 379
 380 static void devm_clkdev_release(void *res)
 381 {
 382         clkdev_drop(res);
 383 }
 384
 385 /**
 386  * devm_clk_hw_register_clkdev - managed clk lookup registration for clk_hw
 387  * @dev: device this lookup is bound
 388  * @hw: struct clk_hw to associate with all clk_lookups
 389  * @con_id: connection ID string on device
 390  * @dev_id: format string describing device name
 391  *
 392  * con_id or dev_id may be NULL as a wildcard, just as in the rest of
 393  * clkdev.
 394  *
 395  * To make things easier for mass registration, we detect error clk_hws
 396  * from a previous clk_hw_register_*() call, and return the error code for
 397  * those.  This is to permit this function to be called immediately
 398  * after clk_hw_register_*().
 399  */
 400 int devm_clk_hw_register_clkdev(struct device *dev, struct clk_hw *hw,
 401                                 const char *con_id, const char *dev_id)
 402 {
 403         struct clk_lookup *cl;
 404         int rval;
 405
 406         rval = do_clk_register_clkdev(hw, &cl, con_id, dev_id);
 407         if (rval)
 408                 return rval;
 409
 410         return devm_add_action_or_reset(dev, devm_clkdev_release, cl);
 411 }
 412 EXPORT_SYMBOL(devm_clk_hw_register_clkdev);