1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun * Copyright 2019 NXP
4*4882a593Smuzhiyun *
5*4882a593Smuzhiyun * Clock driver for LS1028A Display output interfaces(LCD, DPHY).
6*4882a593Smuzhiyun */
7*4882a593Smuzhiyun
8*4882a593Smuzhiyun #include <linux/clk-provider.h>
9*4882a593Smuzhiyun #include <linux/device.h>
10*4882a593Smuzhiyun #include <linux/module.h>
11*4882a593Smuzhiyun #include <linux/err.h>
12*4882a593Smuzhiyun #include <linux/io.h>
13*4882a593Smuzhiyun #include <linux/iopoll.h>
14*4882a593Smuzhiyun #include <linux/of.h>
15*4882a593Smuzhiyun #include <linux/of_address.h>
16*4882a593Smuzhiyun #include <linux/of_device.h>
17*4882a593Smuzhiyun #include <linux/platform_device.h>
18*4882a593Smuzhiyun #include <linux/slab.h>
19*4882a593Smuzhiyun #include <linux/bitfield.h>
20*4882a593Smuzhiyun
21*4882a593Smuzhiyun /* PLLDIG register offsets and bit masks */
22*4882a593Smuzhiyun #define PLLDIG_REG_PLLSR 0x24
23*4882a593Smuzhiyun #define PLLDIG_LOCK_MASK BIT(2)
24*4882a593Smuzhiyun #define PLLDIG_REG_PLLDV 0x28
25*4882a593Smuzhiyun #define PLLDIG_MFD_MASK GENMASK(7, 0)
26*4882a593Smuzhiyun #define PLLDIG_RFDPHI1_MASK GENMASK(30, 25)
27*4882a593Smuzhiyun #define PLLDIG_REG_PLLFM 0x2c
28*4882a593Smuzhiyun #define PLLDIG_SSCGBYP_ENABLE BIT(30)
29*4882a593Smuzhiyun #define PLLDIG_REG_PLLFD 0x30
30*4882a593Smuzhiyun #define PLLDIG_FDEN BIT(30)
31*4882a593Smuzhiyun #define PLLDIG_FRAC_MASK GENMASK(15, 0)
32*4882a593Smuzhiyun #define PLLDIG_REG_PLLCAL1 0x38
33*4882a593Smuzhiyun #define PLLDIG_REG_PLLCAL2 0x3c
34*4882a593Smuzhiyun
35*4882a593Smuzhiyun /* Range of the VCO frequencies, in Hz */
36*4882a593Smuzhiyun #define PLLDIG_MIN_VCO_FREQ 650000000
37*4882a593Smuzhiyun #define PLLDIG_MAX_VCO_FREQ 1300000000
38*4882a593Smuzhiyun
39*4882a593Smuzhiyun /* Range of the output frequencies, in Hz */
40*4882a593Smuzhiyun #define PHI1_MIN_FREQ 27000000UL
41*4882a593Smuzhiyun #define PHI1_MAX_FREQ 600000000UL
42*4882a593Smuzhiyun
43*4882a593Smuzhiyun /* Maximum value of the reduced frequency divider */
44*4882a593Smuzhiyun #define MAX_RFDPHI1 63UL
45*4882a593Smuzhiyun
46*4882a593Smuzhiyun /* Best value of multiplication factor divider */
47*4882a593Smuzhiyun #define PLLDIG_DEFAULT_MFD 44
48*4882a593Smuzhiyun
49*4882a593Smuzhiyun /*
50*4882a593Smuzhiyun * Denominator part of the fractional part of the
51*4882a593Smuzhiyun * loop multiplication factor.
52*4882a593Smuzhiyun */
53*4882a593Smuzhiyun #define MFDEN 20480
54*4882a593Smuzhiyun
55*4882a593Smuzhiyun static const struct clk_parent_data parent_data[] = {
56*4882a593Smuzhiyun { .index = 0 },
57*4882a593Smuzhiyun };
58*4882a593Smuzhiyun
59*4882a593Smuzhiyun struct clk_plldig {
60*4882a593Smuzhiyun struct clk_hw hw;
61*4882a593Smuzhiyun void __iomem *regs;
62*4882a593Smuzhiyun unsigned int vco_freq;
63*4882a593Smuzhiyun };
64*4882a593Smuzhiyun
65*4882a593Smuzhiyun #define to_clk_plldig(_hw) container_of(_hw, struct clk_plldig, hw)
66*4882a593Smuzhiyun
plldig_enable(struct clk_hw * hw)67*4882a593Smuzhiyun static int plldig_enable(struct clk_hw *hw)
68*4882a593Smuzhiyun {
69*4882a593Smuzhiyun struct clk_plldig *data = to_clk_plldig(hw);
70*4882a593Smuzhiyun u32 val;
71*4882a593Smuzhiyun
72*4882a593Smuzhiyun val = readl(data->regs + PLLDIG_REG_PLLFM);
73*4882a593Smuzhiyun /*
74*4882a593Smuzhiyun * Use Bypass mode with PLL off by default, the frequency overshoot
75*4882a593Smuzhiyun * detector output was disable. SSCG Bypass mode should be enable.
76*4882a593Smuzhiyun */
77*4882a593Smuzhiyun val |= PLLDIG_SSCGBYP_ENABLE;
78*4882a593Smuzhiyun writel(val, data->regs + PLLDIG_REG_PLLFM);
79*4882a593Smuzhiyun
80*4882a593Smuzhiyun return 0;
81*4882a593Smuzhiyun }
82*4882a593Smuzhiyun
plldig_disable(struct clk_hw * hw)83*4882a593Smuzhiyun static void plldig_disable(struct clk_hw *hw)
84*4882a593Smuzhiyun {
85*4882a593Smuzhiyun struct clk_plldig *data = to_clk_plldig(hw);
86*4882a593Smuzhiyun u32 val;
87*4882a593Smuzhiyun
88*4882a593Smuzhiyun val = readl(data->regs + PLLDIG_REG_PLLFM);
89*4882a593Smuzhiyun
90*4882a593Smuzhiyun val &= ~PLLDIG_SSCGBYP_ENABLE;
91*4882a593Smuzhiyun val |= FIELD_PREP(PLLDIG_SSCGBYP_ENABLE, 0x0);
92*4882a593Smuzhiyun
93*4882a593Smuzhiyun writel(val, data->regs + PLLDIG_REG_PLLFM);
94*4882a593Smuzhiyun }
95*4882a593Smuzhiyun
plldig_is_enabled(struct clk_hw * hw)96*4882a593Smuzhiyun static int plldig_is_enabled(struct clk_hw *hw)
97*4882a593Smuzhiyun {
98*4882a593Smuzhiyun struct clk_plldig *data = to_clk_plldig(hw);
99*4882a593Smuzhiyun
100*4882a593Smuzhiyun return readl(data->regs + PLLDIG_REG_PLLFM) &
101*4882a593Smuzhiyun PLLDIG_SSCGBYP_ENABLE;
102*4882a593Smuzhiyun }
103*4882a593Smuzhiyun
plldig_recalc_rate(struct clk_hw * hw,unsigned long parent_rate)104*4882a593Smuzhiyun static unsigned long plldig_recalc_rate(struct clk_hw *hw,
105*4882a593Smuzhiyun unsigned long parent_rate)
106*4882a593Smuzhiyun {
107*4882a593Smuzhiyun struct clk_plldig *data = to_clk_plldig(hw);
108*4882a593Smuzhiyun u32 val, rfdphi1;
109*4882a593Smuzhiyun
110*4882a593Smuzhiyun val = readl(data->regs + PLLDIG_REG_PLLDV);
111*4882a593Smuzhiyun
112*4882a593Smuzhiyun /* Check if PLL is bypassed */
113*4882a593Smuzhiyun if (val & PLLDIG_SSCGBYP_ENABLE)
114*4882a593Smuzhiyun return parent_rate;
115*4882a593Smuzhiyun
116*4882a593Smuzhiyun rfdphi1 = FIELD_GET(PLLDIG_RFDPHI1_MASK, val);
117*4882a593Smuzhiyun
118*4882a593Smuzhiyun /*
119*4882a593Smuzhiyun * If RFDPHI1 has a value of 1 the VCO frequency is also divided by
120*4882a593Smuzhiyun * one.
121*4882a593Smuzhiyun */
122*4882a593Smuzhiyun if (!rfdphi1)
123*4882a593Smuzhiyun rfdphi1 = 1;
124*4882a593Smuzhiyun
125*4882a593Smuzhiyun return DIV_ROUND_UP(data->vco_freq, rfdphi1);
126*4882a593Smuzhiyun }
127*4882a593Smuzhiyun
plldig_calc_target_div(unsigned long vco_freq,unsigned long target_rate)128*4882a593Smuzhiyun static unsigned long plldig_calc_target_div(unsigned long vco_freq,
129*4882a593Smuzhiyun unsigned long target_rate)
130*4882a593Smuzhiyun {
131*4882a593Smuzhiyun unsigned long div;
132*4882a593Smuzhiyun
133*4882a593Smuzhiyun div = DIV_ROUND_CLOSEST(vco_freq, target_rate);
134*4882a593Smuzhiyun div = clamp(div, 1UL, MAX_RFDPHI1);
135*4882a593Smuzhiyun
136*4882a593Smuzhiyun return div;
137*4882a593Smuzhiyun }
138*4882a593Smuzhiyun
plldig_determine_rate(struct clk_hw * hw,struct clk_rate_request * req)139*4882a593Smuzhiyun static int plldig_determine_rate(struct clk_hw *hw,
140*4882a593Smuzhiyun struct clk_rate_request *req)
141*4882a593Smuzhiyun {
142*4882a593Smuzhiyun struct clk_plldig *data = to_clk_plldig(hw);
143*4882a593Smuzhiyun unsigned int div;
144*4882a593Smuzhiyun
145*4882a593Smuzhiyun req->rate = clamp(req->rate, PHI1_MIN_FREQ, PHI1_MAX_FREQ);
146*4882a593Smuzhiyun div = plldig_calc_target_div(data->vco_freq, req->rate);
147*4882a593Smuzhiyun req->rate = DIV_ROUND_UP(data->vco_freq, div);
148*4882a593Smuzhiyun
149*4882a593Smuzhiyun return 0;
150*4882a593Smuzhiyun }
151*4882a593Smuzhiyun
plldig_set_rate(struct clk_hw * hw,unsigned long rate,unsigned long parent_rate)152*4882a593Smuzhiyun static int plldig_set_rate(struct clk_hw *hw, unsigned long rate,
153*4882a593Smuzhiyun unsigned long parent_rate)
154*4882a593Smuzhiyun {
155*4882a593Smuzhiyun struct clk_plldig *data = to_clk_plldig(hw);
156*4882a593Smuzhiyun unsigned int val, cond;
157*4882a593Smuzhiyun unsigned int rfdphi1;
158*4882a593Smuzhiyun
159*4882a593Smuzhiyun rate = clamp(rate, PHI1_MIN_FREQ, PHI1_MAX_FREQ);
160*4882a593Smuzhiyun rfdphi1 = plldig_calc_target_div(data->vco_freq, rate);
161*4882a593Smuzhiyun
162*4882a593Smuzhiyun /* update the divider value */
163*4882a593Smuzhiyun val = readl(data->regs + PLLDIG_REG_PLLDV);
164*4882a593Smuzhiyun val &= ~PLLDIG_RFDPHI1_MASK;
165*4882a593Smuzhiyun val |= FIELD_PREP(PLLDIG_RFDPHI1_MASK, rfdphi1);
166*4882a593Smuzhiyun writel(val, data->regs + PLLDIG_REG_PLLDV);
167*4882a593Smuzhiyun
168*4882a593Smuzhiyun /* waiting for old lock state to clear */
169*4882a593Smuzhiyun udelay(200);
170*4882a593Smuzhiyun
171*4882a593Smuzhiyun /* Wait until PLL is locked or timeout */
172*4882a593Smuzhiyun return readl_poll_timeout_atomic(data->regs + PLLDIG_REG_PLLSR, cond,
173*4882a593Smuzhiyun cond & PLLDIG_LOCK_MASK, 0,
174*4882a593Smuzhiyun USEC_PER_MSEC);
175*4882a593Smuzhiyun }
176*4882a593Smuzhiyun
177*4882a593Smuzhiyun static const struct clk_ops plldig_clk_ops = {
178*4882a593Smuzhiyun .enable = plldig_enable,
179*4882a593Smuzhiyun .disable = plldig_disable,
180*4882a593Smuzhiyun .is_enabled = plldig_is_enabled,
181*4882a593Smuzhiyun .recalc_rate = plldig_recalc_rate,
182*4882a593Smuzhiyun .determine_rate = plldig_determine_rate,
183*4882a593Smuzhiyun .set_rate = plldig_set_rate,
184*4882a593Smuzhiyun };
185*4882a593Smuzhiyun
plldig_init(struct clk_hw * hw)186*4882a593Smuzhiyun static int plldig_init(struct clk_hw *hw)
187*4882a593Smuzhiyun {
188*4882a593Smuzhiyun struct clk_plldig *data = to_clk_plldig(hw);
189*4882a593Smuzhiyun struct clk_hw *parent = clk_hw_get_parent(hw);
190*4882a593Smuzhiyun unsigned long parent_rate;
191*4882a593Smuzhiyun unsigned long val;
192*4882a593Smuzhiyun unsigned long long lltmp;
193*4882a593Smuzhiyun unsigned int mfd, fracdiv = 0;
194*4882a593Smuzhiyun
195*4882a593Smuzhiyun if (!parent)
196*4882a593Smuzhiyun return -EINVAL;
197*4882a593Smuzhiyun
198*4882a593Smuzhiyun parent_rate = clk_hw_get_rate(parent);
199*4882a593Smuzhiyun
200*4882a593Smuzhiyun if (data->vco_freq) {
201*4882a593Smuzhiyun mfd = data->vco_freq / parent_rate;
202*4882a593Smuzhiyun lltmp = data->vco_freq % parent_rate;
203*4882a593Smuzhiyun lltmp *= MFDEN;
204*4882a593Smuzhiyun do_div(lltmp, parent_rate);
205*4882a593Smuzhiyun fracdiv = lltmp;
206*4882a593Smuzhiyun } else {
207*4882a593Smuzhiyun mfd = PLLDIG_DEFAULT_MFD;
208*4882a593Smuzhiyun data->vco_freq = parent_rate * mfd;
209*4882a593Smuzhiyun }
210*4882a593Smuzhiyun
211*4882a593Smuzhiyun val = FIELD_PREP(PLLDIG_MFD_MASK, mfd);
212*4882a593Smuzhiyun writel(val, data->regs + PLLDIG_REG_PLLDV);
213*4882a593Smuzhiyun
214*4882a593Smuzhiyun /* Enable fractional divider */
215*4882a593Smuzhiyun if (fracdiv) {
216*4882a593Smuzhiyun val = FIELD_PREP(PLLDIG_FRAC_MASK, fracdiv);
217*4882a593Smuzhiyun val |= PLLDIG_FDEN;
218*4882a593Smuzhiyun writel(val, data->regs + PLLDIG_REG_PLLFD);
219*4882a593Smuzhiyun }
220*4882a593Smuzhiyun
221*4882a593Smuzhiyun return 0;
222*4882a593Smuzhiyun }
223*4882a593Smuzhiyun
plldig_clk_probe(struct platform_device * pdev)224*4882a593Smuzhiyun static int plldig_clk_probe(struct platform_device *pdev)
225*4882a593Smuzhiyun {
226*4882a593Smuzhiyun struct clk_plldig *data;
227*4882a593Smuzhiyun struct device *dev = &pdev->dev;
228*4882a593Smuzhiyun int ret;
229*4882a593Smuzhiyun
230*4882a593Smuzhiyun data = devm_kzalloc(dev, sizeof(*data), GFP_KERNEL);
231*4882a593Smuzhiyun if (!data)
232*4882a593Smuzhiyun return -ENOMEM;
233*4882a593Smuzhiyun
234*4882a593Smuzhiyun data->regs = devm_platform_ioremap_resource(pdev, 0);
235*4882a593Smuzhiyun if (IS_ERR(data->regs))
236*4882a593Smuzhiyun return PTR_ERR(data->regs);
237*4882a593Smuzhiyun
238*4882a593Smuzhiyun data->hw.init = CLK_HW_INIT_PARENTS_DATA("dpclk",
239*4882a593Smuzhiyun parent_data,
240*4882a593Smuzhiyun &plldig_clk_ops,
241*4882a593Smuzhiyun 0);
242*4882a593Smuzhiyun
243*4882a593Smuzhiyun ret = devm_clk_hw_register(dev, &data->hw);
244*4882a593Smuzhiyun if (ret) {
245*4882a593Smuzhiyun dev_err(dev, "failed to register %s clock\n",
246*4882a593Smuzhiyun dev->of_node->name);
247*4882a593Smuzhiyun return ret;
248*4882a593Smuzhiyun }
249*4882a593Smuzhiyun
250*4882a593Smuzhiyun ret = devm_of_clk_add_hw_provider(dev, of_clk_hw_simple_get,
251*4882a593Smuzhiyun &data->hw);
252*4882a593Smuzhiyun if (ret) {
253*4882a593Smuzhiyun dev_err(dev, "unable to add clk provider\n");
254*4882a593Smuzhiyun return ret;
255*4882a593Smuzhiyun }
256*4882a593Smuzhiyun
257*4882a593Smuzhiyun /*
258*4882a593Smuzhiyun * The frequency of the VCO cannot be changed during runtime.
259*4882a593Smuzhiyun * Therefore, let the user specify a desired frequency.
260*4882a593Smuzhiyun */
261*4882a593Smuzhiyun if (!of_property_read_u32(dev->of_node, "fsl,vco-hz",
262*4882a593Smuzhiyun &data->vco_freq)) {
263*4882a593Smuzhiyun if (data->vco_freq < PLLDIG_MIN_VCO_FREQ ||
264*4882a593Smuzhiyun data->vco_freq > PLLDIG_MAX_VCO_FREQ)
265*4882a593Smuzhiyun return -EINVAL;
266*4882a593Smuzhiyun }
267*4882a593Smuzhiyun
268*4882a593Smuzhiyun return plldig_init(&data->hw);
269*4882a593Smuzhiyun }
270*4882a593Smuzhiyun
271*4882a593Smuzhiyun static const struct of_device_id plldig_clk_id[] = {
272*4882a593Smuzhiyun { .compatible = "fsl,ls1028a-plldig" },
273*4882a593Smuzhiyun { }
274*4882a593Smuzhiyun };
275*4882a593Smuzhiyun MODULE_DEVICE_TABLE(of, plldig_clk_id);
276*4882a593Smuzhiyun
277*4882a593Smuzhiyun static struct platform_driver plldig_clk_driver = {
278*4882a593Smuzhiyun .driver = {
279*4882a593Smuzhiyun .name = "plldig-clock",
280*4882a593Smuzhiyun .of_match_table = plldig_clk_id,
281*4882a593Smuzhiyun },
282*4882a593Smuzhiyun .probe = plldig_clk_probe,
283*4882a593Smuzhiyun };
284*4882a593Smuzhiyun module_platform_driver(plldig_clk_driver);
285*4882a593Smuzhiyun
286*4882a593Smuzhiyun MODULE_LICENSE("GPL v2");
287*4882a593Smuzhiyun MODULE_AUTHOR("Wen He <wen.he_1@nxp.com>");
288*4882a593Smuzhiyun MODULE_DESCRIPTION("LS1028A Display output interface pixel clock driver");
289