xref: /openbmc/linux/drivers/clk/clk-mux.c (revision a8fe58ce)
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  * Simple multiplexer clock implementation
11  */
12 
13 #include <linux/clk-provider.h>
14 #include <linux/module.h>
15 #include <linux/slab.h>
16 #include <linux/io.h>
17 #include <linux/err.h>
18 
19 /*
20  * DOC: basic adjustable multiplexer clock that cannot gate
21  *
22  * Traits of this clock:
23  * prepare - clk_prepare only ensures that parents are prepared
24  * enable - clk_enable only ensures that parents are enabled
25  * rate - rate is only affected by parent switching.  No clk_set_rate support
26  * parent - parent is adjustable through clk_set_parent
27  */
28 
29 #define to_clk_mux(_hw) container_of(_hw, struct clk_mux, hw)
30 
31 static u8 clk_mux_get_parent(struct clk_hw *hw)
32 {
33 	struct clk_mux *mux = to_clk_mux(hw);
34 	int num_parents = clk_hw_get_num_parents(hw);
35 	u32 val;
36 
37 	/*
38 	 * FIXME need a mux-specific flag to determine if val is bitwise or numeric
39 	 * e.g. sys_clkin_ck's clksel field is 3 bits wide, but ranges from 0x1
40 	 * to 0x7 (index starts at one)
41 	 * OTOH, pmd_trace_clk_mux_ck uses a separate bit for each clock, so
42 	 * val = 0x4 really means "bit 2, index starts at bit 0"
43 	 */
44 	val = clk_readl(mux->reg) >> mux->shift;
45 	val &= mux->mask;
46 
47 	if (mux->table) {
48 		int i;
49 
50 		for (i = 0; i < num_parents; i++)
51 			if (mux->table[i] == val)
52 				return i;
53 		return -EINVAL;
54 	}
55 
56 	if (val && (mux->flags & CLK_MUX_INDEX_BIT))
57 		val = ffs(val) - 1;
58 
59 	if (val && (mux->flags & CLK_MUX_INDEX_ONE))
60 		val--;
61 
62 	if (val >= num_parents)
63 		return -EINVAL;
64 
65 	return val;
66 }
67 
68 static int clk_mux_set_parent(struct clk_hw *hw, u8 index)
69 {
70 	struct clk_mux *mux = to_clk_mux(hw);
71 	u32 val;
72 	unsigned long flags = 0;
73 
74 	if (mux->table) {
75 		index = mux->table[index];
76 	} else {
77 		if (mux->flags & CLK_MUX_INDEX_BIT)
78 			index = 1 << index;
79 
80 		if (mux->flags & CLK_MUX_INDEX_ONE)
81 			index++;
82 	}
83 
84 	if (mux->lock)
85 		spin_lock_irqsave(mux->lock, flags);
86 	else
87 		__acquire(mux->lock);
88 
89 	if (mux->flags & CLK_MUX_HIWORD_MASK) {
90 		val = mux->mask << (mux->shift + 16);
91 	} else {
92 		val = clk_readl(mux->reg);
93 		val &= ~(mux->mask << mux->shift);
94 	}
95 	val |= index << mux->shift;
96 	clk_writel(val, mux->reg);
97 
98 	if (mux->lock)
99 		spin_unlock_irqrestore(mux->lock, flags);
100 	else
101 		__release(mux->lock);
102 
103 	return 0;
104 }
105 
106 const struct clk_ops clk_mux_ops = {
107 	.get_parent = clk_mux_get_parent,
108 	.set_parent = clk_mux_set_parent,
109 	.determine_rate = __clk_mux_determine_rate,
110 };
111 EXPORT_SYMBOL_GPL(clk_mux_ops);
112 
113 const struct clk_ops clk_mux_ro_ops = {
114 	.get_parent = clk_mux_get_parent,
115 };
116 EXPORT_SYMBOL_GPL(clk_mux_ro_ops);
117 
118 struct clk *clk_register_mux_table(struct device *dev, const char *name,
119 		const char * const *parent_names, u8 num_parents,
120 		unsigned long flags,
121 		void __iomem *reg, u8 shift, u32 mask,
122 		u8 clk_mux_flags, u32 *table, spinlock_t *lock)
123 {
124 	struct clk_mux *mux;
125 	struct clk *clk;
126 	struct clk_init_data init;
127 	u8 width = 0;
128 
129 	if (clk_mux_flags & CLK_MUX_HIWORD_MASK) {
130 		width = fls(mask) - ffs(mask) + 1;
131 		if (width + shift > 16) {
132 			pr_err("mux value exceeds LOWORD field\n");
133 			return ERR_PTR(-EINVAL);
134 		}
135 	}
136 
137 	/* allocate the mux */
138 	mux = kzalloc(sizeof(struct clk_mux), GFP_KERNEL);
139 	if (!mux) {
140 		pr_err("%s: could not allocate mux clk\n", __func__);
141 		return ERR_PTR(-ENOMEM);
142 	}
143 
144 	init.name = name;
145 	if (clk_mux_flags & CLK_MUX_READ_ONLY)
146 		init.ops = &clk_mux_ro_ops;
147 	else
148 		init.ops = &clk_mux_ops;
149 	init.flags = flags | CLK_IS_BASIC;
150 	init.parent_names = parent_names;
151 	init.num_parents = num_parents;
152 
153 	/* struct clk_mux assignments */
154 	mux->reg = reg;
155 	mux->shift = shift;
156 	mux->mask = mask;
157 	mux->flags = clk_mux_flags;
158 	mux->lock = lock;
159 	mux->table = table;
160 	mux->hw.init = &init;
161 
162 	clk = clk_register(dev, &mux->hw);
163 
164 	if (IS_ERR(clk))
165 		kfree(mux);
166 
167 	return clk;
168 }
169 EXPORT_SYMBOL_GPL(clk_register_mux_table);
170 
171 struct clk *clk_register_mux(struct device *dev, const char *name,
172 		const char * const *parent_names, u8 num_parents,
173 		unsigned long flags,
174 		void __iomem *reg, u8 shift, u8 width,
175 		u8 clk_mux_flags, spinlock_t *lock)
176 {
177 	u32 mask = BIT(width) - 1;
178 
179 	return clk_register_mux_table(dev, name, parent_names, num_parents,
180 				      flags, reg, shift, mask, clk_mux_flags,
181 				      NULL, lock);
182 }
183 EXPORT_SYMBOL_GPL(clk_register_mux);
184 
185 void clk_unregister_mux(struct clk *clk)
186 {
187 	struct clk_mux *mux;
188 	struct clk_hw *hw;
189 
190 	hw = __clk_get_hw(clk);
191 	if (!hw)
192 		return;
193 
194 	mux = to_clk_mux(hw);
195 
196 	clk_unregister(clk);
197 	kfree(mux);
198 }
199 EXPORT_SYMBOL_GPL(clk_unregister_mux);
200