/drivers/clk/clk-divider.c

https://github.com/tworaz/linux · C · 321 lines · 216 code · 48 blank · 57 comment · 36 complexity · aef658da429cf1e3dd381f92895faa2f MD5 · raw file

  1. /*
  2. * Copyright (C) 2011 Sascha Hauer, Pengutronix <s.hauer@pengutronix.de>
  3. * Copyright (C) 2011 Richard Zhao, Linaro <richard.zhao@linaro.org>
  4. * Copyright (C) 2011-2012 Mike Turquette, Linaro Ltd <mturquette@linaro.org>
  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. * Adjustable divider clock implementation
  11. */
  12. #include <linux/clk-provider.h>
  13. #include <linux/module.h>
  14. #include <linux/slab.h>
  15. #include <linux/io.h>
  16. #include <linux/err.h>
  17. #include <linux/string.h>
  18. /*
  19. * DOC: basic adjustable divider clock that cannot gate
  20. *
  21. * Traits of this clock:
  22. * prepare - clk_prepare only ensures that parents are prepared
  23. * enable - clk_enable only ensures that parents are enabled
  24. * rate - rate is adjustable. clk->rate = parent->rate / divisor
  25. * parent - fixed parent. No clk_set_parent support
  26. */
  27. #define to_clk_divider(_hw) container_of(_hw, struct clk_divider, hw)
  28. #define div_mask(d) ((1 << (d->width)) - 1)
  29. #define is_power_of_two(i) !(i & ~i)
  30. static unsigned int _get_table_maxdiv(const struct clk_div_table *table)
  31. {
  32. unsigned int maxdiv = 0;
  33. const struct clk_div_table *clkt;
  34. for (clkt = table; clkt->div; clkt++)
  35. if (clkt->div > maxdiv)
  36. maxdiv = clkt->div;
  37. return maxdiv;
  38. }
  39. static unsigned int _get_maxdiv(struct clk_divider *divider)
  40. {
  41. if (divider->flags & CLK_DIVIDER_ONE_BASED)
  42. return div_mask(divider);
  43. if (divider->flags & CLK_DIVIDER_POWER_OF_TWO)
  44. return 1 << div_mask(divider);
  45. if (divider->table)
  46. return _get_table_maxdiv(divider->table);
  47. return div_mask(divider) + 1;
  48. }
  49. static unsigned int _get_table_div(const struct clk_div_table *table,
  50. unsigned int val)
  51. {
  52. const struct clk_div_table *clkt;
  53. for (clkt = table; clkt->div; clkt++)
  54. if (clkt->val == val)
  55. return clkt->div;
  56. return 0;
  57. }
  58. static unsigned int _get_div(struct clk_divider *divider, unsigned int val)
  59. {
  60. if (divider->flags & CLK_DIVIDER_ONE_BASED)
  61. return val;
  62. if (divider->flags & CLK_DIVIDER_POWER_OF_TWO)
  63. return 1 << val;
  64. if (divider->table)
  65. return _get_table_div(divider->table, val);
  66. return val + 1;
  67. }
  68. static unsigned int _get_table_val(const struct clk_div_table *table,
  69. unsigned int div)
  70. {
  71. const struct clk_div_table *clkt;
  72. for (clkt = table; clkt->div; clkt++)
  73. if (clkt->div == div)
  74. return clkt->val;
  75. return 0;
  76. }
  77. static unsigned int _get_val(struct clk_divider *divider, u8 div)
  78. {
  79. if (divider->flags & CLK_DIVIDER_ONE_BASED)
  80. return div;
  81. if (divider->flags & CLK_DIVIDER_POWER_OF_TWO)
  82. return __ffs(div);
  83. if (divider->table)
  84. return _get_table_val(divider->table, div);
  85. return div - 1;
  86. }
  87. static unsigned long clk_divider_recalc_rate(struct clk_hw *hw,
  88. unsigned long parent_rate)
  89. {
  90. struct clk_divider *divider = to_clk_divider(hw);
  91. unsigned int div, val;
  92. val = readl(divider->reg) >> divider->shift;
  93. val &= div_mask(divider);
  94. div = _get_div(divider, val);
  95. if (!div) {
  96. WARN(1, "%s: Invalid divisor for clock %s\n", __func__,
  97. __clk_get_name(hw->clk));
  98. return parent_rate;
  99. }
  100. return parent_rate / div;
  101. }
  102. /*
  103. * The reverse of DIV_ROUND_UP: The maximum number which
  104. * divided by m is r
  105. */
  106. #define MULT_ROUND_UP(r, m) ((r) * (m) + (m) - 1)
  107. static bool _is_valid_table_div(const struct clk_div_table *table,
  108. unsigned int div)
  109. {
  110. const struct clk_div_table *clkt;
  111. for (clkt = table; clkt->div; clkt++)
  112. if (clkt->div == div)
  113. return true;
  114. return false;
  115. }
  116. static bool _is_valid_div(struct clk_divider *divider, unsigned int div)
  117. {
  118. if (divider->flags & CLK_DIVIDER_POWER_OF_TWO)
  119. return is_power_of_two(div);
  120. if (divider->table)
  121. return _is_valid_table_div(divider->table, div);
  122. return true;
  123. }
  124. static int clk_divider_bestdiv(struct clk_hw *hw, unsigned long rate,
  125. unsigned long *best_parent_rate)
  126. {
  127. struct clk_divider *divider = to_clk_divider(hw);
  128. int i, bestdiv = 0;
  129. unsigned long parent_rate, best = 0, now, maxdiv;
  130. if (!rate)
  131. rate = 1;
  132. maxdiv = _get_maxdiv(divider);
  133. if (!(__clk_get_flags(hw->clk) & CLK_SET_RATE_PARENT)) {
  134. parent_rate = *best_parent_rate;
  135. bestdiv = DIV_ROUND_UP(parent_rate, rate);
  136. bestdiv = bestdiv == 0 ? 1 : bestdiv;
  137. bestdiv = bestdiv > maxdiv ? maxdiv : bestdiv;
  138. return bestdiv;
  139. }
  140. /*
  141. * The maximum divider we can use without overflowing
  142. * unsigned long in rate * i below
  143. */
  144. maxdiv = min(ULONG_MAX / rate, maxdiv);
  145. for (i = 1; i <= maxdiv; i++) {
  146. if (!_is_valid_div(divider, i))
  147. continue;
  148. parent_rate = __clk_round_rate(__clk_get_parent(hw->clk),
  149. MULT_ROUND_UP(rate, i));
  150. now = parent_rate / i;
  151. if (now <= rate && now > best) {
  152. bestdiv = i;
  153. best = now;
  154. *best_parent_rate = parent_rate;
  155. }
  156. }
  157. if (!bestdiv) {
  158. bestdiv = _get_maxdiv(divider);
  159. *best_parent_rate = __clk_round_rate(__clk_get_parent(hw->clk), 1);
  160. }
  161. return bestdiv;
  162. }
  163. static long clk_divider_round_rate(struct clk_hw *hw, unsigned long rate,
  164. unsigned long *prate)
  165. {
  166. int div;
  167. div = clk_divider_bestdiv(hw, rate, prate);
  168. return *prate / div;
  169. }
  170. static int clk_divider_set_rate(struct clk_hw *hw, unsigned long rate,
  171. unsigned long parent_rate)
  172. {
  173. struct clk_divider *divider = to_clk_divider(hw);
  174. unsigned int div, value;
  175. unsigned long flags = 0;
  176. u32 val;
  177. div = parent_rate / rate;
  178. value = _get_val(divider, div);
  179. if (value > div_mask(divider))
  180. value = div_mask(divider);
  181. if (divider->lock)
  182. spin_lock_irqsave(divider->lock, flags);
  183. val = readl(divider->reg);
  184. val &= ~(div_mask(divider) << divider->shift);
  185. val |= value << divider->shift;
  186. writel(val, divider->reg);
  187. if (divider->lock)
  188. spin_unlock_irqrestore(divider->lock, flags);
  189. return 0;
  190. }
  191. const struct clk_ops clk_divider_ops = {
  192. .recalc_rate = clk_divider_recalc_rate,
  193. .round_rate = clk_divider_round_rate,
  194. .set_rate = clk_divider_set_rate,
  195. };
  196. EXPORT_SYMBOL_GPL(clk_divider_ops);
  197. static struct clk *_register_divider(struct device *dev, const char *name,
  198. const char *parent_name, unsigned long flags,
  199. void __iomem *reg, u8 shift, u8 width,
  200. u8 clk_divider_flags, const struct clk_div_table *table,
  201. spinlock_t *lock)
  202. {
  203. struct clk_divider *div;
  204. struct clk *clk;
  205. struct clk_init_data init;
  206. /* allocate the divider */
  207. div = kzalloc(sizeof(struct clk_divider), GFP_KERNEL);
  208. if (!div) {
  209. pr_err("%s: could not allocate divider clk\n", __func__);
  210. return ERR_PTR(-ENOMEM);
  211. }
  212. init.name = name;
  213. init.ops = &clk_divider_ops;
  214. init.flags = flags | CLK_IS_BASIC;
  215. init.parent_names = (parent_name ? &parent_name: NULL);
  216. init.num_parents = (parent_name ? 1 : 0);
  217. /* struct clk_divider assignments */
  218. div->reg = reg;
  219. div->shift = shift;
  220. div->width = width;
  221. div->flags = clk_divider_flags;
  222. div->lock = lock;
  223. div->hw.init = &init;
  224. div->table = table;
  225. /* register the clock */
  226. clk = clk_register(dev, &div->hw);
  227. if (IS_ERR(clk))
  228. kfree(div);
  229. return clk;
  230. }
  231. /**
  232. * clk_register_divider - register a divider clock with the clock framework
  233. * @dev: device registering this clock
  234. * @name: name of this clock
  235. * @parent_name: name of clock's parent
  236. * @flags: framework-specific flags
  237. * @reg: register address to adjust divider
  238. * @shift: number of bits to shift the bitfield
  239. * @width: width of the bitfield
  240. * @clk_divider_flags: divider-specific flags for this clock
  241. * @lock: shared register lock for this clock
  242. */
  243. struct clk *clk_register_divider(struct device *dev, const char *name,
  244. const char *parent_name, unsigned long flags,
  245. void __iomem *reg, u8 shift, u8 width,
  246. u8 clk_divider_flags, spinlock_t *lock)
  247. {
  248. return _register_divider(dev, name, parent_name, flags, reg, shift,
  249. width, clk_divider_flags, NULL, lock);
  250. }
  251. /**
  252. * clk_register_divider_table - register a table based divider clock with
  253. * the clock framework
  254. * @dev: device registering this clock
  255. * @name: name of this clock
  256. * @parent_name: name of clock's parent
  257. * @flags: framework-specific flags
  258. * @reg: register address to adjust divider
  259. * @shift: number of bits to shift the bitfield
  260. * @width: width of the bitfield
  261. * @clk_divider_flags: divider-specific flags for this clock
  262. * @table: array of divider/value pairs ending with a div set to 0
  263. * @lock: shared register lock for this clock
  264. */
  265. struct clk *clk_register_divider_table(struct device *dev, const char *name,
  266. const char *parent_name, unsigned long flags,
  267. void __iomem *reg, u8 shift, u8 width,
  268. u8 clk_divider_flags, const struct clk_div_table *table,
  269. spinlock_t *lock)
  270. {
  271. return _register_divider(dev, name, parent_name, flags, reg, shift,
  272. width, clk_divider_flags, table, lock);
  273. }