xref: /openbmc/linux/drivers/clk/ti/dpll44xx.c (revision a266ef69)
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3  * OMAP4-specific DPLL control functions
4  *
5  * Copyright (C) 2011 Texas Instruments, Inc.
6  * Rajendra Nayak
7  */
8 
9 #include <linux/kernel.h>
10 #include <linux/errno.h>
11 #include <linux/clk.h>
12 #include <linux/io.h>
13 #include <linux/bitops.h>
14 #include <linux/clk/ti.h>
15 
16 #include "clock.h"
17 
18 /*
19  * Maximum DPLL input frequency (FINT) and output frequency (FOUT) that
20  * can supported when using the DPLL low-power mode. Frequencies are
21  * defined in OMAP4430/60 Public TRM section 3.6.3.3.2 "Enable Control,
22  * Status, and Low-Power Operation Mode".
23  */
24 #define OMAP4_DPLL_LP_FINT_MAX	1000000
25 #define OMAP4_DPLL_LP_FOUT_MAX	100000000
26 
27 /*
28  * Bitfield declarations
29  */
30 #define OMAP4430_DPLL_CLKOUT_GATE_CTRL_MASK		BIT(8)
31 #define OMAP4430_DPLL_CLKOUTX2_GATE_CTRL_MASK		BIT(10)
32 #define OMAP4430_DPLL_REGM4XEN_MASK			BIT(11)
33 
34 /* Static rate multiplier for OMAP4 REGM4XEN clocks */
35 #define OMAP4430_REGM4XEN_MULT				4
36 
37 static void omap4_dpllmx_allow_gatectrl(struct clk_hw_omap *clk)
38 {
39 	u32 v;
40 	u32 mask;
41 
42 	if (!clk)
43 		return;
44 
45 	mask = clk->flags & CLOCK_CLKOUTX2 ?
46 			OMAP4430_DPLL_CLKOUTX2_GATE_CTRL_MASK :
47 			OMAP4430_DPLL_CLKOUT_GATE_CTRL_MASK;
48 
49 	v = ti_clk_ll_ops->clk_readl(&clk->clksel_reg);
50 	/* Clear the bit to allow gatectrl */
51 	v &= ~mask;
52 	ti_clk_ll_ops->clk_writel(v, &clk->clksel_reg);
53 }
54 
55 static void omap4_dpllmx_deny_gatectrl(struct clk_hw_omap *clk)
56 {
57 	u32 v;
58 	u32 mask;
59 
60 	if (!clk)
61 		return;
62 
63 	mask = clk->flags & CLOCK_CLKOUTX2 ?
64 			OMAP4430_DPLL_CLKOUTX2_GATE_CTRL_MASK :
65 			OMAP4430_DPLL_CLKOUT_GATE_CTRL_MASK;
66 
67 	v = ti_clk_ll_ops->clk_readl(&clk->clksel_reg);
68 	/* Set the bit to deny gatectrl */
69 	v |= mask;
70 	ti_clk_ll_ops->clk_writel(v, &clk->clksel_reg);
71 }
72 
73 const struct clk_hw_omap_ops clkhwops_omap4_dpllmx = {
74 	.allow_idle	= omap4_dpllmx_allow_gatectrl,
75 	.deny_idle      = omap4_dpllmx_deny_gatectrl,
76 };
77 
78 /**
79  * omap4_dpll_lpmode_recalc - compute DPLL low-power setting
80  * @dd: pointer to the dpll data structure
81  *
82  * Calculates if low-power mode can be enabled based upon the last
83  * multiplier and divider values calculated. If low-power mode can be
84  * enabled, then the bit to enable low-power mode is stored in the
85  * last_rounded_lpmode variable. This implementation is based upon the
86  * criteria for enabling low-power mode as described in the OMAP4430/60
87  * Public TRM section 3.6.3.3.2 "Enable Control, Status, and Low-Power
88  * Operation Mode".
89  */
90 static void omap4_dpll_lpmode_recalc(struct dpll_data *dd)
91 {
92 	long fint, fout;
93 
94 	fint = clk_hw_get_rate(dd->clk_ref) / (dd->last_rounded_n + 1);
95 	fout = fint * dd->last_rounded_m;
96 
97 	if ((fint < OMAP4_DPLL_LP_FINT_MAX) && (fout < OMAP4_DPLL_LP_FOUT_MAX))
98 		dd->last_rounded_lpmode = 1;
99 	else
100 		dd->last_rounded_lpmode = 0;
101 }
102 
103 /**
104  * omap4_dpll_regm4xen_recalc - compute DPLL rate, considering REGM4XEN bit
105  * @hw: pointer to the clock to compute the rate for
106  * @parent_rate: clock rate of the DPLL parent
107  *
108  * Compute the output rate for the OMAP4 DPLL represented by @clk.
109  * Takes the REGM4XEN bit into consideration, which is needed for the
110  * OMAP4 ABE DPLL.  Returns the DPLL's output rate (before M-dividers)
111  * upon success, or 0 upon error.
112  */
113 unsigned long omap4_dpll_regm4xen_recalc(struct clk_hw *hw,
114 					 unsigned long parent_rate)
115 {
116 	struct clk_hw_omap *clk = to_clk_hw_omap(hw);
117 	u32 v;
118 	unsigned long rate;
119 	struct dpll_data *dd;
120 
121 	if (!clk || !clk->dpll_data)
122 		return 0;
123 
124 	dd = clk->dpll_data;
125 
126 	rate = omap2_get_dpll_rate(clk);
127 
128 	/* regm4xen adds a multiplier of 4 to DPLL calculations */
129 	v = ti_clk_ll_ops->clk_readl(&dd->control_reg);
130 	if (v & OMAP4430_DPLL_REGM4XEN_MASK)
131 		rate *= OMAP4430_REGM4XEN_MULT;
132 
133 	return rate;
134 }
135 
136 /**
137  * omap4_dpll_regm4xen_round_rate - round DPLL rate, considering REGM4XEN bit
138  * @hw: struct hw_clk containing the struct clk * of the DPLL to round a rate for
139  * @target_rate: the desired rate of the DPLL
140  * @parent_rate: clock rate of the DPLL parent
141  *
142  * Compute the rate that would be programmed into the DPLL hardware
143  * for @clk if set_rate() were to be provided with the rate
144  * @target_rate.  Takes the REGM4XEN bit into consideration, which is
145  * needed for the OMAP4 ABE DPLL.  Returns the rounded rate (before
146  * M-dividers) upon success, -EINVAL if @clk is null or not a DPLL, or
147  * ~0 if an error occurred in omap2_dpll_round_rate().
148  */
149 long omap4_dpll_regm4xen_round_rate(struct clk_hw *hw,
150 				    unsigned long target_rate,
151 				    unsigned long *parent_rate)
152 {
153 	struct clk_hw_omap *clk = to_clk_hw_omap(hw);
154 	struct dpll_data *dd;
155 	long r;
156 
157 	if (!clk || !clk->dpll_data)
158 		return -EINVAL;
159 
160 	dd = clk->dpll_data;
161 
162 	dd->last_rounded_m4xen = 0;
163 
164 	/*
165 	 * First try to compute the DPLL configuration for
166 	 * target rate without using the 4X multiplier.
167 	 */
168 	r = omap2_dpll_round_rate(hw, target_rate, NULL);
169 	if (r != ~0)
170 		goto out;
171 
172 	/*
173 	 * If we did not find a valid DPLL configuration, try again, but
174 	 * this time see if using the 4X multiplier can help. Enabling the
175 	 * 4X multiplier is equivalent to dividing the target rate by 4.
176 	 */
177 	r = omap2_dpll_round_rate(hw, target_rate / OMAP4430_REGM4XEN_MULT,
178 				  NULL);
179 	if (r == ~0)
180 		return r;
181 
182 	dd->last_rounded_rate *= OMAP4430_REGM4XEN_MULT;
183 	dd->last_rounded_m4xen = 1;
184 
185 out:
186 	omap4_dpll_lpmode_recalc(dd);
187 
188 	return dd->last_rounded_rate;
189 }
190 
191 /**
192  * omap4_dpll_regm4xen_determine_rate - determine rate for a DPLL
193  * @hw: pointer to the clock to determine rate for
194  * @req: target rate request
195  *
196  * Determines which DPLL mode to use for reaching a desired rate.
197  * Checks whether the DPLL shall be in bypass or locked mode, and if
198  * locked, calculates the M,N values for the DPLL via round-rate.
199  * Returns 0 on success and a negative error value otherwise.
200  */
201 int omap4_dpll_regm4xen_determine_rate(struct clk_hw *hw,
202 				       struct clk_rate_request *req)
203 {
204 	struct clk_hw_omap *clk = to_clk_hw_omap(hw);
205 	struct dpll_data *dd;
206 
207 	if (!req->rate)
208 		return -EINVAL;
209 
210 	dd = clk->dpll_data;
211 	if (!dd)
212 		return -EINVAL;
213 
214 	if (clk_hw_get_rate(dd->clk_bypass) == req->rate &&
215 	    (dd->modes & (1 << DPLL_LOW_POWER_BYPASS))) {
216 		req->best_parent_hw = dd->clk_bypass;
217 	} else {
218 		req->rate = omap4_dpll_regm4xen_round_rate(hw, req->rate,
219 						&req->best_parent_rate);
220 		req->best_parent_hw = dd->clk_ref;
221 	}
222 
223 	req->best_parent_rate = req->rate;
224 
225 	return 0;
226 }
227