Merge commit 'v2.6.39' into 20110526
[linux-2.6.git] / arch / arm / mach-tegra / clock.c
1 /*
2  *
3  * Copyright (C) 2010 Google, Inc.
4  *
5  * Author:
6  *      Colin Cross <ccross@google.com>
7  *
8  * This software is licensed under the terms of the GNU General Public
9  * License version 2, as published by the Free Software Foundation, and
10  * may be copied, distributed, and modified under those terms.
11  *
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  * GNU General Public License for more details.
16  *
17  */
18
19 #include <linux/kernel.h>
20 #include <linux/clk.h>
21 #include <linux/clkdev.h>
22 #include <linux/debugfs.h>
23 #include <linux/delay.h>
24 #include <linux/init.h>
25 #include <linux/list.h>
26 #include <linux/module.h>
27 #include <linux/sched.h>
28 #include <linux/seq_file.h>
29 #include <linux/slab.h>
30
31 #include <mach/clk.h>
32
33 #include "board.h"
34 #include "clock.h"
35
36 /*
37  * Locking:
38  *
39  * Each struct clk has a spinlock.
40  *
41  * To avoid AB-BA locking problems, locks must always be traversed from child
42  * clock to parent clock.  For example, when enabling a clock, the clock's lock
43  * is taken, and then clk_enable is called on the parent, which take's the
44  * parent clock's lock.  There is one exceptions to this ordering: When dumping
45  * the clock tree through debugfs.  In this case, clk_lock_all is called,
46  * which attemps to iterate through the entire list of clocks and take every
47  * clock lock.  If any call to spin_trylock fails, all locked clocks are
48  * unlocked, and the process is retried.  When all the locks are held,
49  * the only clock operation that can be called is clk_get_rate_all_locked.
50  *
51  * Within a single clock, no clock operation can call another clock operation
52  * on itself, except for clk_get_rate_locked and clk_set_rate_locked.  Any
53  * clock operation can call any other clock operation on any of it's possible
54  * parents.
55  *
56  * An additional mutex, clock_list_lock, is used to protect the list of all
57  * clocks.
58  *
59  * The clock operations must lock internally to protect against
60  * read-modify-write on registers that are shared by multiple clocks
61  */
62 static DEFINE_MUTEX(clock_list_lock);
63 static LIST_HEAD(clocks);
64
65 struct clk *tegra_get_clock_by_name(const char *name)
66 {
67         struct clk *c;
68         struct clk *ret = NULL;
69         mutex_lock(&clock_list_lock);
70         list_for_each_entry(c, &clocks, node) {
71                 if (strcmp(c->name, name) == 0) {
72                         ret = c;
73                         break;
74                 }
75         }
76         mutex_unlock(&clock_list_lock);
77         return ret;
78 }
79
80 /* Must be called with c->spinlock held */
81 static unsigned long clk_predict_rate_from_parent(struct clk *c, struct clk *p)
82 {
83         u64 rate;
84
85         rate = clk_get_rate(p);
86
87         if (c->mul != 0 && c->div != 0) {
88                 rate *= c->mul;
89                 rate += c->div - 1; /* round up */
90                 do_div(rate, c->div);
91         }
92
93         return rate;
94 }
95
96 /* Must be called with c->spinlock held */
97 unsigned long clk_get_rate_locked(struct clk *c)
98 {
99         unsigned long rate;
100
101         if (c->parent)
102                 rate = clk_predict_rate_from_parent(c, c->parent);
103         else
104                 rate = c->rate;
105
106         return rate;
107 }
108
109 unsigned long clk_get_rate(struct clk *c)
110 {
111         unsigned long flags;
112         unsigned long rate;
113
114         spin_lock_irqsave(&c->spinlock, flags);
115
116         rate = clk_get_rate_locked(c);
117
118         spin_unlock_irqrestore(&c->spinlock, flags);
119
120         return rate;
121 }
122 EXPORT_SYMBOL(clk_get_rate);
123
124 int clk_reparent(struct clk *c, struct clk *parent)
125 {
126         c->parent = parent;
127         return 0;
128 }
129
130 void clk_init(struct clk *c)
131 {
132         spin_lock_init(&c->spinlock);
133
134         if (c->ops && c->ops->init)
135                 c->ops->init(c);
136
137         if (!c->ops || !c->ops->enable) {
138                 c->refcnt++;
139                 c->set = true;
140                 if (c->parent)
141                         c->state = c->parent->state;
142                 else
143                         c->state = ON;
144         }
145
146         mutex_lock(&clock_list_lock);
147         list_add(&c->node, &clocks);
148         mutex_unlock(&clock_list_lock);
149 }
150
151 int clk_enable(struct clk *c)
152 {
153         int ret = 0;
154         unsigned long flags;
155
156         spin_lock_irqsave(&c->spinlock, flags);
157
158         if (c->refcnt == 0) {
159                 if (c->parent) {
160                         ret = clk_enable(c->parent);
161                         if (ret)
162                                 goto out;
163                 }
164
165                 if (c->ops && c->ops->enable) {
166                         ret = c->ops->enable(c);
167                         if (ret) {
168                                 if (c->parent)
169                                         clk_disable(c->parent);
170                                 goto out;
171                         }
172                         c->state = ON;
173                         c->set = true;
174                 }
175         }
176         c->refcnt++;
177 out:
178         spin_unlock_irqrestore(&c->spinlock, flags);
179         return ret;
180 }
181 EXPORT_SYMBOL(clk_enable);
182
183 void clk_disable(struct clk *c)
184 {
185         unsigned long flags;
186
187         spin_lock_irqsave(&c->spinlock, flags);
188
189         if (c->refcnt == 0) {
190                 WARN(1, "Attempting to disable clock %s with refcnt 0", c->name);
191                 spin_unlock_irqrestore(&c->spinlock, flags);
192                 return;
193         }
194         if (c->refcnt == 1) {
195                 if (c->ops && c->ops->disable)
196                         c->ops->disable(c);
197
198                 if (c->parent)
199                         clk_disable(c->parent);
200
201                 c->state = OFF;
202         }
203         c->refcnt--;
204
205         spin_unlock_irqrestore(&c->spinlock, flags);
206 }
207 EXPORT_SYMBOL(clk_disable);
208
209 int clk_set_parent(struct clk *c, struct clk *parent)
210 {
211         int ret;
212         unsigned long flags;
213         unsigned long new_rate;
214         unsigned long old_rate;
215
216         spin_lock_irqsave(&c->spinlock, flags);
217
218         if (!c->ops || !c->ops->set_parent) {
219                 ret = -ENOSYS;
220                 goto out;
221         }
222
223         new_rate = clk_predict_rate_from_parent(c, parent);
224         old_rate = clk_get_rate_locked(c);
225
226         ret = c->ops->set_parent(c, parent);
227         if (ret)
228                 goto out;
229
230 out:
231         spin_unlock_irqrestore(&c->spinlock, flags);
232         return ret;
233 }
234 EXPORT_SYMBOL(clk_set_parent);
235
236 struct clk *clk_get_parent(struct clk *c)
237 {
238         return c->parent;
239 }
240 EXPORT_SYMBOL(clk_get_parent);
241
242 int clk_set_rate_locked(struct clk *c, unsigned long rate)
243 {
244         long new_rate;
245
246         if (!c->ops || !c->ops->set_rate)
247                 return -ENOSYS;
248
249         if (rate > c->max_rate)
250                 rate = c->max_rate;
251
252         if (c->ops && c->ops->round_rate) {
253                 new_rate = c->ops->round_rate(c, rate);
254
255                 if (new_rate < 0)
256                         return new_rate;
257
258                 rate = new_rate;
259         }
260
261         return c->ops->set_rate(c, rate);
262 }
263
264 int clk_set_rate(struct clk *c, unsigned long rate)
265 {
266         int ret;
267         unsigned long flags;
268
269         spin_lock_irqsave(&c->spinlock, flags);
270
271         ret = clk_set_rate_locked(c, rate);
272
273         spin_unlock_irqrestore(&c->spinlock, flags);
274
275         return ret;
276 }
277 EXPORT_SYMBOL(clk_set_rate);
278
279
280 /* Must be called with clocks lock and all indvidual clock locks held */
281 unsigned long clk_get_rate_all_locked(struct clk *c)
282 {
283         u64 rate;
284         int mul = 1;
285         int div = 1;
286         struct clk *p = c;
287
288         while (p) {
289                 c = p;
290                 if (c->mul != 0 && c->div != 0) {
291                         mul *= c->mul;
292                         div *= c->div;
293                 }
294                 p = c->parent;
295         }
296
297         rate = c->rate;
298         rate *= mul;
299         do_div(rate, div);
300
301         return rate;
302 }
303
304 long clk_round_rate(struct clk *c, unsigned long rate)
305 {
306         unsigned long flags;
307         long ret;
308
309         spin_lock_irqsave(&c->spinlock, flags);
310
311         if (!c->ops || !c->ops->round_rate) {
312                 ret = -ENOSYS;
313                 goto out;
314         }
315
316         if (rate > c->max_rate)
317                 rate = c->max_rate;
318
319         ret = c->ops->round_rate(c, rate);
320
321 out:
322         spin_unlock_irqrestore(&c->spinlock, flags);
323         return ret;
324 }
325 EXPORT_SYMBOL(clk_round_rate);
326
327 static int tegra_clk_init_one_from_table(struct tegra_clk_init_table *table)
328 {
329         struct clk *c;
330         struct clk *p;
331
332         int ret = 0;
333
334         c = tegra_get_clock_by_name(table->name);
335
336         if (!c) {
337                 pr_warning("Unable to initialize clock %s\n",
338                         table->name);
339                 return -ENODEV;
340         }
341
342         if (table->parent) {
343                 p = tegra_get_clock_by_name(table->parent);
344                 if (!p) {
345                         pr_warning("Unable to find parent %s of clock %s\n",
346                                 table->parent, table->name);
347                         return -ENODEV;
348                 }
349
350                 if (c->parent != p) {
351                         ret = clk_set_parent(c, p);
352                         if (ret) {
353                                 pr_warning("Unable to set parent %s of clock %s: %d\n",
354                                         table->parent, table->name, ret);
355                                 return -EINVAL;
356                         }
357                 }
358         }
359
360         if (table->rate && table->rate != clk_get_rate(c)) {
361                 ret = clk_set_rate(c, table->rate);
362                 if (ret) {
363                         pr_warning("Unable to set clock %s to rate %lu: %d\n",
364                                 table->name, table->rate, ret);
365                         return -EINVAL;
366                 }
367         }
368
369         if (table->enabled) {
370                 ret = clk_enable(c);
371                 if (ret) {
372                         pr_warning("Unable to enable clock %s: %d\n",
373                                 table->name, ret);
374                         return -EINVAL;
375                 }
376         }
377
378         return 0;
379 }
380
381 void tegra_clk_init_from_table(struct tegra_clk_init_table *table)
382 {
383         for (; table->name; table++)
384                 tegra_clk_init_one_from_table(table);
385 }
386 EXPORT_SYMBOL(tegra_clk_init_from_table);
387
388 void tegra_periph_reset_deassert(struct clk *c)
389 {
390         tegra2_periph_reset_deassert(c);
391 }
392 EXPORT_SYMBOL(tegra_periph_reset_deassert);
393
394 void tegra_periph_reset_assert(struct clk *c)
395 {
396         tegra2_periph_reset_assert(c);
397 }
398 EXPORT_SYMBOL(tegra_periph_reset_assert);
399
400 void __init tegra_init_clock(void)
401 {
402         tegra2_init_clocks();
403 }
404
405 /*
406  * The SDMMC controllers have extra bits in the clock source register that
407  * adjust the delay between the clock and data to compenstate for delays
408  * on the PCB.
409  */
410 void tegra_sdmmc_tap_delay(struct clk *c, int delay)
411 {
412         unsigned long flags;
413
414         spin_lock_irqsave(&c->spinlock, flags);
415         tegra2_sdmmc_tap_delay(c, delay);
416         spin_unlock_irqrestore(&c->spinlock, flags);
417 }
418
419 #ifdef CONFIG_DEBUG_FS
420
421 static int __clk_lock_all_spinlocks(void)
422 {
423         struct clk *c;
424
425         list_for_each_entry(c, &clocks, node)
426                 if (!spin_trylock(&c->spinlock))
427                         goto unlock_spinlocks;
428
429         return 0;
430
431 unlock_spinlocks:
432         list_for_each_entry_continue_reverse(c, &clocks, node)
433                 spin_unlock(&c->spinlock);
434
435         return -EAGAIN;
436 }
437
438 static void __clk_unlock_all_spinlocks(void)
439 {
440         struct clk *c;
441
442         list_for_each_entry_reverse(c, &clocks, node)
443                 spin_unlock(&c->spinlock);
444 }
445
446 /*
447  * This function retries until it can take all locks, and may take
448  * an arbitrarily long time to complete.
449  * Must be called with irqs enabled, returns with irqs disabled
450  * Must be called with clock_list_lock held
451  */
452 static void clk_lock_all(void)
453 {
454         int ret;
455 retry:
456         local_irq_disable();
457
458         ret = __clk_lock_all_spinlocks();
459         if (ret)
460                 goto failed_spinlocks;
461
462         /* All locks taken successfully, return */
463         return;
464
465 failed_spinlocks:
466         local_irq_enable();
467         yield();
468         goto retry;
469 }
470
471 /*
472  * Unlocks all clocks after a clk_lock_all
473  * Must be called with irqs disabled, returns with irqs enabled
474  * Must be called with clock_list_lock held
475  */
476 static void clk_unlock_all(void)
477 {
478         __clk_unlock_all_spinlocks();
479
480         local_irq_enable();
481 }
482
483 static struct dentry *clk_debugfs_root;
484
485
486 static void clock_tree_show_one(struct seq_file *s, struct clk *c, int level)
487 {
488         struct clk *child;
489         const char *state = "uninit";
490         char div[8] = {0};
491
492         if (c->state == ON)
493                 state = "on";
494         else if (c->state == OFF)
495                 state = "off";
496
497         if (c->mul != 0 && c->div != 0) {
498                 if (c->mul > c->div) {
499                         int mul = c->mul / c->div;
500                         int mul2 = (c->mul * 10 / c->div) % 10;
501                         int mul3 = (c->mul * 10) % c->div;
502                         if (mul2 == 0 && mul3 == 0)
503                                 snprintf(div, sizeof(div), "x%d", mul);
504                         else if (mul3 == 0)
505                                 snprintf(div, sizeof(div), "x%d.%d", mul, mul2);
506                         else
507                                 snprintf(div, sizeof(div), "x%d.%d..", mul, mul2);
508                 } else {
509                         snprintf(div, sizeof(div), "%d%s", c->div / c->mul,
510                                 (c->div % c->mul) ? ".5" : "");
511                 }
512         }
513
514         seq_printf(s, "%*s%c%c%-*s %-6s %-3d %-8s %-10lu\n",
515                 level * 3 + 1, "",
516                 c->rate > c->max_rate ? '!' : ' ',
517                 !c->set ? '*' : ' ',
518                 30 - level * 3, c->name,
519                 state, c->refcnt, div, clk_get_rate_all_locked(c));
520
521         list_for_each_entry(child, &clocks, node) {
522                 if (child->parent != c)
523                         continue;
524
525                 clock_tree_show_one(s, child, level + 1);
526         }
527 }
528
529 static int clock_tree_show(struct seq_file *s, void *data)
530 {
531         struct clk *c;
532         seq_printf(s, "   clock                          state  ref div      rate\n");
533         seq_printf(s, "--------------------------------------------------------------\n");
534
535         mutex_lock(&clock_list_lock);
536
537         clk_lock_all();
538
539         list_for_each_entry(c, &clocks, node)
540                 if (c->parent == NULL)
541                         clock_tree_show_one(s, c, 0);
542
543         clk_unlock_all();
544
545         mutex_unlock(&clock_list_lock);
546         return 0;
547 }
548
549 static int clock_tree_open(struct inode *inode, struct file *file)
550 {
551         return single_open(file, clock_tree_show, inode->i_private);
552 }
553
554 static const struct file_operations clock_tree_fops = {
555         .open           = clock_tree_open,
556         .read           = seq_read,
557         .llseek         = seq_lseek,
558         .release        = single_release,
559 };
560
561 static int possible_parents_show(struct seq_file *s, void *data)
562 {
563         struct clk *c = s->private;
564         int i;
565
566         for (i = 0; c->inputs[i].input; i++) {
567                 char *first = (i == 0) ? "" : " ";
568                 seq_printf(s, "%s%s", first, c->inputs[i].input->name);
569         }
570         seq_printf(s, "\n");
571         return 0;
572 }
573
574 static int possible_parents_open(struct inode *inode, struct file *file)
575 {
576         return single_open(file, possible_parents_show, inode->i_private);
577 }
578
579 static const struct file_operations possible_parents_fops = {
580         .open           = possible_parents_open,
581         .read           = seq_read,
582         .llseek         = seq_lseek,
583         .release        = single_release,
584 };
585
586 static int clk_debugfs_register_one(struct clk *c)
587 {
588         struct dentry *d, *child, *child_tmp;
589
590         d = debugfs_create_dir(c->name, clk_debugfs_root);
591         if (!d)
592                 return -ENOMEM;
593         c->dent = d;
594
595         d = debugfs_create_u8("refcnt", S_IRUGO, c->dent, (u8 *)&c->refcnt);
596         if (!d)
597                 goto err_out;
598
599         d = debugfs_create_u32("rate", S_IRUGO, c->dent, (u32 *)&c->rate);
600         if (!d)
601                 goto err_out;
602
603         d = debugfs_create_x32("flags", S_IRUGO, c->dent, (u32 *)&c->flags);
604         if (!d)
605                 goto err_out;
606
607         if (c->inputs) {
608                 d = debugfs_create_file("possible_parents", S_IRUGO, c->dent,
609                         c, &possible_parents_fops);
610                 if (!d)
611                         goto err_out;
612         }
613
614         return 0;
615
616 err_out:
617         d = c->dent;
618         list_for_each_entry_safe(child, child_tmp, &d->d_subdirs, d_u.d_child)
619                 debugfs_remove(child);
620         debugfs_remove(c->dent);
621         return -ENOMEM;
622 }
623
624 static int clk_debugfs_register(struct clk *c)
625 {
626         int err;
627         struct clk *pa = c->parent;
628
629         if (pa && !pa->dent) {
630                 err = clk_debugfs_register(pa);
631                 if (err)
632                         return err;
633         }
634
635         if (!c->dent) {
636                 err = clk_debugfs_register_one(c);
637                 if (err)
638                         return err;
639         }
640         return 0;
641 }
642
643 static int __init clk_debugfs_init(void)
644 {
645         struct clk *c;
646         struct dentry *d;
647         int err = -ENOMEM;
648
649         d = debugfs_create_dir("clock", NULL);
650         if (!d)
651                 return -ENOMEM;
652         clk_debugfs_root = d;
653
654         d = debugfs_create_file("clock_tree", S_IRUGO, clk_debugfs_root, NULL,
655                 &clock_tree_fops);
656         if (!d)
657                 goto err_out;
658
659         list_for_each_entry(c, &clocks, node) {
660                 err = clk_debugfs_register(c);
661                 if (err)
662                         goto err_out;
663         }
664         return 0;
665 err_out:
666         debugfs_remove_recursive(clk_debugfs_root);
667         return err;
668 }
669
670 late_initcall(clk_debugfs_init);
671 #endif