1 // SPDX-License-Identifier: GPL-2.0-only
3 * Copyright (c) 2014 MundoReader S.L.
4 * Author: Heiko Stuebner <heiko@sntech.de>
6 * based on clk/samsung/clk-cpu.c
7 * Copyright (c) 2014 Samsung Electronics Co., Ltd.
8 * Author: Thomas Abraham <thomas.ab@samsung.com>
10 * A CPU clock is defined as a clock supplied to a CPU or a group of CPUs.
11 * The CPU clock is typically derived from a hierarchy of clock
12 * blocks which includes mux and divider blocks. There are a number of other
13 * auxiliary clocks supplied to the CPU domain such as the debug blocks and AXI
14 * clock for CPU domain. The rates of these auxiliary clocks are related to the
15 * CPU clock rate and this relation is usually specified in the hardware manual
16 * of the SoC or supplied after the SoC characterization.
18 * The below implementation of the CPU clock allows the rate changes of the CPU
19 * clock and the corresponding rate changes of the auxillary clocks of the CPU
20 * domain. The platform clock driver provides a clock register configuration
21 * for each configurable rate which is then used to program the clock hardware
22 * registers to acheive a fast co-oridinated rate change for all the CPU domain
25 * On a rate change request for the CPU clock, the rate change is propagated
26 * upto the PLL supplying the clock to the CPU domain clock blocks. While the
27 * CPU domain PLL is reconfigured, the CPU domain clocks are driven using an
28 * alternate clock source. If required, the alternate clock source is divided
29 * down in order to keep the output clock rate within the previous OPP limits.
33 #include <linux/slab.h>
35 #include <linux/clk.h>
36 #include <linux/clk-provider.h>
40 * struct rockchip_cpuclk: information about clock supplied to a CPU core.
41 * @hw: handle between ccf and cpu clock.
42 * @alt_parent: alternate parent clock to use when switching the speed
43 * of the primary parent clock.
44 * @reg_base: base register for cpu-clock values.
45 * @clk_nb: clock notifier registered for changes in clock speed of the
46 * primary parent clock.
47 * @rate_count: number of rates in the rate_table
48 * @rate_table: pll-rates and their associated dividers
49 * @reg_data: cpu-specific register settings
52 struct rockchip_cpuclk
{
54 struct clk
*alt_parent
;
55 void __iomem
*reg_base
;
56 struct notifier_block clk_nb
;
57 unsigned int rate_count
;
58 struct rockchip_cpuclk_rate_table
*rate_table
;
59 const struct rockchip_cpuclk_reg_data
*reg_data
;
63 #define to_rockchip_cpuclk_hw(hw) container_of(hw, struct rockchip_cpuclk, hw)
64 #define to_rockchip_cpuclk_nb(nb) \
65 container_of(nb, struct rockchip_cpuclk, clk_nb)
67 static const struct rockchip_cpuclk_rate_table
*rockchip_get_cpuclk_settings(
68 struct rockchip_cpuclk
*cpuclk
, unsigned long rate
)
70 const struct rockchip_cpuclk_rate_table
*rate_table
=
74 for (i
= 0; i
< cpuclk
->rate_count
; i
++) {
75 if (rate
== rate_table
[i
].prate
)
76 return &rate_table
[i
];
82 static unsigned long rockchip_cpuclk_recalc_rate(struct clk_hw
*hw
,
83 unsigned long parent_rate
)
85 struct rockchip_cpuclk
*cpuclk
= to_rockchip_cpuclk_hw(hw
);
86 const struct rockchip_cpuclk_reg_data
*reg_data
= cpuclk
->reg_data
;
87 u32 clksel0
= readl_relaxed(cpuclk
->reg_base
+ reg_data
->core_reg
[0]);
89 clksel0
>>= reg_data
->div_core_shift
[0];
90 clksel0
&= reg_data
->div_core_mask
[0];
91 return parent_rate
/ (clksel0
+ 1);
94 static const struct clk_ops rockchip_cpuclk_ops
= {
95 .recalc_rate
= rockchip_cpuclk_recalc_rate
,
98 static void rockchip_cpuclk_set_dividers(struct rockchip_cpuclk
*cpuclk
,
99 const struct rockchip_cpuclk_rate_table
*rate
)
103 /* alternate parent is active now. set the dividers */
104 for (i
= 0; i
< ARRAY_SIZE(rate
->divs
); i
++) {
105 const struct rockchip_cpuclk_clksel
*clksel
= &rate
->divs
[i
];
110 pr_debug("%s: setting reg 0x%x to 0x%x\n",
111 __func__
, clksel
->reg
, clksel
->val
);
112 writel(clksel
->val
, cpuclk
->reg_base
+ clksel
->reg
);
116 static void rockchip_cpuclk_set_pre_muxs(struct rockchip_cpuclk
*cpuclk
,
117 const struct rockchip_cpuclk_rate_table
*rate
)
121 /* alternate parent is active now. set the pre_muxs */
122 for (i
= 0; i
< ARRAY_SIZE(rate
->pre_muxs
); i
++) {
123 const struct rockchip_cpuclk_clksel
*clksel
= &rate
->pre_muxs
[i
];
128 pr_debug("%s: setting reg 0x%x to 0x%x\n",
129 __func__
, clksel
->reg
, clksel
->val
);
130 writel(clksel
->val
, cpuclk
->reg_base
+ clksel
->reg
);
134 static void rockchip_cpuclk_set_post_muxs(struct rockchip_cpuclk
*cpuclk
,
135 const struct rockchip_cpuclk_rate_table
*rate
)
139 /* alternate parent is active now. set the muxs */
140 for (i
= 0; i
< ARRAY_SIZE(rate
->post_muxs
); i
++) {
141 const struct rockchip_cpuclk_clksel
*clksel
= &rate
->post_muxs
[i
];
146 pr_debug("%s: setting reg 0x%x to 0x%x\n",
147 __func__
, clksel
->reg
, clksel
->val
);
148 writel(clksel
->val
, cpuclk
->reg_base
+ clksel
->reg
);
152 static int rockchip_cpuclk_pre_rate_change(struct rockchip_cpuclk
*cpuclk
,
153 struct clk_notifier_data
*ndata
)
155 const struct rockchip_cpuclk_reg_data
*reg_data
= cpuclk
->reg_data
;
156 const struct rockchip_cpuclk_rate_table
*rate
;
157 unsigned long alt_prate
, alt_div
;
161 /* check validity of the new rate */
162 rate
= rockchip_get_cpuclk_settings(cpuclk
, ndata
->new_rate
);
164 pr_err("%s: Invalid rate : %lu for cpuclk\n",
165 __func__
, ndata
->new_rate
);
169 alt_prate
= clk_get_rate(cpuclk
->alt_parent
);
171 spin_lock_irqsave(cpuclk
->lock
, flags
);
174 * If the old parent clock speed is less than the clock speed
175 * of the alternate parent, then it should be ensured that at no point
176 * the armclk speed is more than the old_rate until the dividers are
179 if (alt_prate
> ndata
->old_rate
) {
180 /* calculate dividers */
181 alt_div
= DIV_ROUND_UP(alt_prate
, ndata
->old_rate
) - 1;
182 if (alt_div
> reg_data
->div_core_mask
[0]) {
183 pr_warn("%s: limiting alt-divider %lu to %d\n",
184 __func__
, alt_div
, reg_data
->div_core_mask
[0]);
185 alt_div
= reg_data
->div_core_mask
[0];
189 * Change parents and add dividers in a single transaction.
191 * NOTE: we do this in a single transaction so we're never
192 * dividing the primary parent by the extra dividers that were
193 * needed for the alt.
195 pr_debug("%s: setting div %lu as alt-rate %lu > old-rate %lu\n",
196 __func__
, alt_div
, alt_prate
, ndata
->old_rate
);
198 for (i
= 0; i
< reg_data
->num_cores
; i
++) {
199 writel(HIWORD_UPDATE(alt_div
, reg_data
->div_core_mask
[i
],
200 reg_data
->div_core_shift
[i
]),
201 cpuclk
->reg_base
+ reg_data
->core_reg
[i
]);
205 rockchip_cpuclk_set_pre_muxs(cpuclk
, rate
);
207 /* select alternate parent */
208 if (reg_data
->mux_core_reg
)
209 writel(HIWORD_UPDATE(reg_data
->mux_core_alt
,
210 reg_data
->mux_core_mask
,
211 reg_data
->mux_core_shift
),
212 cpuclk
->reg_base
+ reg_data
->mux_core_reg
);
214 writel(HIWORD_UPDATE(reg_data
->mux_core_alt
,
215 reg_data
->mux_core_mask
,
216 reg_data
->mux_core_shift
),
217 cpuclk
->reg_base
+ reg_data
->core_reg
[0]);
219 spin_unlock_irqrestore(cpuclk
->lock
, flags
);
223 static int rockchip_cpuclk_post_rate_change(struct rockchip_cpuclk
*cpuclk
,
224 struct clk_notifier_data
*ndata
)
226 const struct rockchip_cpuclk_reg_data
*reg_data
= cpuclk
->reg_data
;
227 const struct rockchip_cpuclk_rate_table
*rate
;
231 rate
= rockchip_get_cpuclk_settings(cpuclk
, ndata
->new_rate
);
233 pr_err("%s: Invalid rate : %lu for cpuclk\n",
234 __func__
, ndata
->new_rate
);
238 spin_lock_irqsave(cpuclk
->lock
, flags
);
240 if (ndata
->old_rate
< ndata
->new_rate
)
241 rockchip_cpuclk_set_dividers(cpuclk
, rate
);
244 * post-rate change event, re-mux to primary parent and remove dividers.
246 * NOTE: we do this in a single transaction so we're never dividing the
247 * primary parent by the extra dividers that were needed for the alt.
250 if (reg_data
->mux_core_reg
)
251 writel(HIWORD_UPDATE(reg_data
->mux_core_main
,
252 reg_data
->mux_core_mask
,
253 reg_data
->mux_core_shift
),
254 cpuclk
->reg_base
+ reg_data
->mux_core_reg
);
256 writel(HIWORD_UPDATE(reg_data
->mux_core_main
,
257 reg_data
->mux_core_mask
,
258 reg_data
->mux_core_shift
),
259 cpuclk
->reg_base
+ reg_data
->core_reg
[0]);
261 rockchip_cpuclk_set_post_muxs(cpuclk
, rate
);
263 /* remove dividers */
264 for (i
= 0; i
< reg_data
->num_cores
; i
++) {
265 writel(HIWORD_UPDATE(0, reg_data
->div_core_mask
[i
],
266 reg_data
->div_core_shift
[i
]),
267 cpuclk
->reg_base
+ reg_data
->core_reg
[i
]);
270 if (ndata
->old_rate
> ndata
->new_rate
)
271 rockchip_cpuclk_set_dividers(cpuclk
, rate
);
273 spin_unlock_irqrestore(cpuclk
->lock
, flags
);
278 * This clock notifier is called when the frequency of the parent clock
279 * of cpuclk is to be changed. This notifier handles the setting up all
280 * the divider clocks, remux to temporary parent and handling the safe
281 * frequency levels when using temporary parent.
283 static int rockchip_cpuclk_notifier_cb(struct notifier_block
*nb
,
284 unsigned long event
, void *data
)
286 struct clk_notifier_data
*ndata
= data
;
287 struct rockchip_cpuclk
*cpuclk
= to_rockchip_cpuclk_nb(nb
);
290 pr_debug("%s: event %lu, old_rate %lu, new_rate: %lu\n",
291 __func__
, event
, ndata
->old_rate
, ndata
->new_rate
);
292 if (event
== PRE_RATE_CHANGE
)
293 ret
= rockchip_cpuclk_pre_rate_change(cpuclk
, ndata
);
294 else if (event
== POST_RATE_CHANGE
)
295 ret
= rockchip_cpuclk_post_rate_change(cpuclk
, ndata
);
297 return notifier_from_errno(ret
);
300 struct clk
*rockchip_clk_register_cpuclk(const char *name
,
301 const char *const *parent_names
, u8 num_parents
,
302 const struct rockchip_cpuclk_reg_data
*reg_data
,
303 const struct rockchip_cpuclk_rate_table
*rates
,
304 int nrates
, void __iomem
*reg_base
, spinlock_t
*lock
)
306 struct rockchip_cpuclk
*cpuclk
;
307 struct clk_init_data init
;
308 struct clk
*clk
, *cclk
;
311 if (num_parents
< 2) {
312 pr_err("%s: needs at least two parent clocks\n", __func__
);
313 return ERR_PTR(-EINVAL
);
316 cpuclk
= kzalloc(sizeof(*cpuclk
), GFP_KERNEL
);
318 return ERR_PTR(-ENOMEM
);
321 init
.parent_names
= &parent_names
[reg_data
->mux_core_main
];
322 init
.num_parents
= 1;
323 init
.ops
= &rockchip_cpuclk_ops
;
325 /* only allow rate changes when we have a rate table */
326 init
.flags
= (nrates
> 0) ? CLK_SET_RATE_PARENT
: 0;
328 /* disallow automatic parent changes by ccf */
329 init
.flags
|= CLK_SET_RATE_NO_REPARENT
;
331 init
.flags
|= CLK_GET_RATE_NOCACHE
;
333 cpuclk
->reg_base
= reg_base
;
335 cpuclk
->reg_data
= reg_data
;
336 cpuclk
->clk_nb
.notifier_call
= rockchip_cpuclk_notifier_cb
;
337 cpuclk
->hw
.init
= &init
;
339 cpuclk
->alt_parent
= __clk_lookup(parent_names
[reg_data
->mux_core_alt
]);
340 if (!cpuclk
->alt_parent
) {
341 pr_err("%s: could not lookup alternate parent: (%d)\n",
342 __func__
, reg_data
->mux_core_alt
);
347 ret
= clk_prepare_enable(cpuclk
->alt_parent
);
349 pr_err("%s: could not enable alternate parent\n",
354 clk
= __clk_lookup(parent_names
[reg_data
->mux_core_main
]);
356 pr_err("%s: could not lookup parent clock: (%d) %s\n",
357 __func__
, reg_data
->mux_core_main
,
358 parent_names
[reg_data
->mux_core_main
]);
360 goto free_alt_parent
;
363 ret
= clk_notifier_register(clk
, &cpuclk
->clk_nb
);
365 pr_err("%s: failed to register clock notifier for %s\n",
367 goto free_alt_parent
;
371 cpuclk
->rate_count
= nrates
;
372 cpuclk
->rate_table
= kmemdup_array(rates
, nrates
, sizeof(*rates
),
374 if (!cpuclk
->rate_table
) {
376 goto unregister_notifier
;
380 cclk
= clk_register(NULL
, &cpuclk
->hw
);
382 pr_err("%s: could not register cpuclk %s\n", __func__
, name
);
384 goto free_rate_table
;
390 kfree(cpuclk
->rate_table
);
392 clk_notifier_unregister(clk
, &cpuclk
->clk_nb
);
394 clk_disable_unprepare(cpuclk
->alt_parent
);