xref: /openbmc/linux/drivers/clk/sifive/sifive-prci.h (revision 27ab1c1c)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * Copyright (C) 2018-2019 SiFive, Inc.
4  * Wesley Terpstra
5  * Paul Walmsley
6  * Zong Li
7  */
8 
9 #ifndef __SIFIVE_CLK_SIFIVE_PRCI_H
10 #define __SIFIVE_CLK_SIFIVE_PRCI_H
11 
12 #include <linux/clk/analogbits-wrpll-cln28hpc.h>
13 #include <linux/clk-provider.h>
14 #include <linux/platform_device.h>
15 
16 /*
17  * EXPECTED_CLK_PARENT_COUNT: how many parent clocks this driver expects:
18  *     hfclk and rtcclk
19  */
20 #define EXPECTED_CLK_PARENT_COUNT 2
21 
22 /*
23  * Register offsets and bitmasks
24  */
25 
26 /* COREPLLCFG0 */
27 #define PRCI_COREPLLCFG0_OFFSET		0x4
28 #define PRCI_COREPLLCFG0_DIVR_SHIFT	0
29 #define PRCI_COREPLLCFG0_DIVR_MASK	(0x3f << PRCI_COREPLLCFG0_DIVR_SHIFT)
30 #define PRCI_COREPLLCFG0_DIVF_SHIFT	6
31 #define PRCI_COREPLLCFG0_DIVF_MASK	(0x1ff << PRCI_COREPLLCFG0_DIVF_SHIFT)
32 #define PRCI_COREPLLCFG0_DIVQ_SHIFT	15
33 #define PRCI_COREPLLCFG0_DIVQ_MASK	(0x7 << PRCI_COREPLLCFG0_DIVQ_SHIFT)
34 #define PRCI_COREPLLCFG0_RANGE_SHIFT	18
35 #define PRCI_COREPLLCFG0_RANGE_MASK	(0x7 << PRCI_COREPLLCFG0_RANGE_SHIFT)
36 #define PRCI_COREPLLCFG0_BYPASS_SHIFT	24
37 #define PRCI_COREPLLCFG0_BYPASS_MASK	(0x1 << PRCI_COREPLLCFG0_BYPASS_SHIFT)
38 #define PRCI_COREPLLCFG0_FSE_SHIFT	25
39 #define PRCI_COREPLLCFG0_FSE_MASK	(0x1 << PRCI_COREPLLCFG0_FSE_SHIFT)
40 #define PRCI_COREPLLCFG0_LOCK_SHIFT	31
41 #define PRCI_COREPLLCFG0_LOCK_MASK	(0x1 << PRCI_COREPLLCFG0_LOCK_SHIFT)
42 
43 /* COREPLLCFG1 */
44 #define PRCI_COREPLLCFG1_OFFSET		0x8
45 #define PRCI_COREPLLCFG1_CKE_SHIFT	31
46 #define PRCI_COREPLLCFG1_CKE_MASK	(0x1 << PRCI_COREPLLCFG1_CKE_SHIFT)
47 
48 /* DDRPLLCFG0 */
49 #define PRCI_DDRPLLCFG0_OFFSET		0xc
50 #define PRCI_DDRPLLCFG0_DIVR_SHIFT	0
51 #define PRCI_DDRPLLCFG0_DIVR_MASK	(0x3f << PRCI_DDRPLLCFG0_DIVR_SHIFT)
52 #define PRCI_DDRPLLCFG0_DIVF_SHIFT	6
53 #define PRCI_DDRPLLCFG0_DIVF_MASK	(0x1ff << PRCI_DDRPLLCFG0_DIVF_SHIFT)
54 #define PRCI_DDRPLLCFG0_DIVQ_SHIFT	15
55 #define PRCI_DDRPLLCFG0_DIVQ_MASK	(0x7 << PRCI_DDRPLLCFG0_DIVQ_SHIFT)
56 #define PRCI_DDRPLLCFG0_RANGE_SHIFT	18
57 #define PRCI_DDRPLLCFG0_RANGE_MASK	(0x7 << PRCI_DDRPLLCFG0_RANGE_SHIFT)
58 #define PRCI_DDRPLLCFG0_BYPASS_SHIFT	24
59 #define PRCI_DDRPLLCFG0_BYPASS_MASK	(0x1 << PRCI_DDRPLLCFG0_BYPASS_SHIFT)
60 #define PRCI_DDRPLLCFG0_FSE_SHIFT	25
61 #define PRCI_DDRPLLCFG0_FSE_MASK	(0x1 << PRCI_DDRPLLCFG0_FSE_SHIFT)
62 #define PRCI_DDRPLLCFG0_LOCK_SHIFT	31
63 #define PRCI_DDRPLLCFG0_LOCK_MASK	(0x1 << PRCI_DDRPLLCFG0_LOCK_SHIFT)
64 
65 /* DDRPLLCFG1 */
66 #define PRCI_DDRPLLCFG1_OFFSET		0x10
67 #define PRCI_DDRPLLCFG1_CKE_SHIFT	31
68 #define PRCI_DDRPLLCFG1_CKE_MASK	(0x1 << PRCI_DDRPLLCFG1_CKE_SHIFT)
69 
70 /* GEMGXLPLLCFG0 */
71 #define PRCI_GEMGXLPLLCFG0_OFFSET	0x1c
72 #define PRCI_GEMGXLPLLCFG0_DIVR_SHIFT	0
73 #define PRCI_GEMGXLPLLCFG0_DIVR_MASK	(0x3f << PRCI_GEMGXLPLLCFG0_DIVR_SHIFT)
74 #define PRCI_GEMGXLPLLCFG0_DIVF_SHIFT	6
75 #define PRCI_GEMGXLPLLCFG0_DIVF_MASK	(0x1ff << PRCI_GEMGXLPLLCFG0_DIVF_SHIFT)
76 #define PRCI_GEMGXLPLLCFG0_DIVQ_SHIFT	15
77 #define PRCI_GEMGXLPLLCFG0_DIVQ_MASK	(0x7 << PRCI_GEMGXLPLLCFG0_DIVQ_SHIFT)
78 #define PRCI_GEMGXLPLLCFG0_RANGE_SHIFT	18
79 #define PRCI_GEMGXLPLLCFG0_RANGE_MASK	(0x7 << PRCI_GEMGXLPLLCFG0_RANGE_SHIFT)
80 #define PRCI_GEMGXLPLLCFG0_BYPASS_SHIFT	24
81 #define PRCI_GEMGXLPLLCFG0_BYPASS_MASK	(0x1 << PRCI_GEMGXLPLLCFG0_BYPASS_SHIFT)
82 #define PRCI_GEMGXLPLLCFG0_FSE_SHIFT	25
83 #define PRCI_GEMGXLPLLCFG0_FSE_MASK	(0x1 << PRCI_GEMGXLPLLCFG0_FSE_SHIFT)
84 #define PRCI_GEMGXLPLLCFG0_LOCK_SHIFT	31
85 #define PRCI_GEMGXLPLLCFG0_LOCK_MASK	(0x1 << PRCI_GEMGXLPLLCFG0_LOCK_SHIFT)
86 
87 /* GEMGXLPLLCFG1 */
88 #define PRCI_GEMGXLPLLCFG1_OFFSET	0x20
89 #define PRCI_GEMGXLPLLCFG1_CKE_SHIFT	31
90 #define PRCI_GEMGXLPLLCFG1_CKE_MASK	(0x1 << PRCI_GEMGXLPLLCFG1_CKE_SHIFT)
91 
92 /* CORECLKSEL */
93 #define PRCI_CORECLKSEL_OFFSET			0x24
94 #define PRCI_CORECLKSEL_CORECLKSEL_SHIFT	0
95 #define PRCI_CORECLKSEL_CORECLKSEL_MASK					\
96 		(0x1 << PRCI_CORECLKSEL_CORECLKSEL_SHIFT)
97 
98 /* DEVICESRESETREG */
99 #define PRCI_DEVICESRESETREG_OFFSET				0x28
100 #define PRCI_DEVICESRESETREG_DDR_CTRL_RST_N_SHIFT		0
101 #define PRCI_DEVICESRESETREG_DDR_CTRL_RST_N_MASK			\
102 		(0x1 << PRCI_DEVICESRESETREG_DDR_CTRL_RST_N_SHIFT)
103 #define PRCI_DEVICESRESETREG_DDR_AXI_RST_N_SHIFT		1
104 #define PRCI_DEVICESRESETREG_DDR_AXI_RST_N_MASK				\
105 		(0x1 << PRCI_DEVICESRESETREG_DDR_AXI_RST_N_SHIFT)
106 #define PRCI_DEVICESRESETREG_DDR_AHB_RST_N_SHIFT		2
107 #define PRCI_DEVICESRESETREG_DDR_AHB_RST_N_MASK				\
108 		(0x1 << PRCI_DEVICESRESETREG_DDR_AHB_RST_N_SHIFT)
109 #define PRCI_DEVICESRESETREG_DDR_PHY_RST_N_SHIFT		3
110 #define PRCI_DEVICESRESETREG_DDR_PHY_RST_N_MASK				\
111 		(0x1 << PRCI_DEVICESRESETREG_DDR_PHY_RST_N_SHIFT)
112 #define PRCI_DEVICESRESETREG_GEMGXL_RST_N_SHIFT			5
113 #define PRCI_DEVICESRESETREG_GEMGXL_RST_N_MASK				\
114 		(0x1 << PRCI_DEVICESRESETREG_GEMGXL_RST_N_SHIFT)
115 #define PRCI_DEVICESRESETREG_CHIPLINK_RST_N_SHIFT		6
116 #define PRCI_DEVICESRESETREG_CHIPLINK_RST_N_MASK			\
117 		(0x1 << PRCI_DEVICESRESETREG_CHIPLINK_RST_N_SHIFT)
118 
119 /* CLKMUXSTATUSREG */
120 #define PRCI_CLKMUXSTATUSREG_OFFSET				0x2c
121 #define PRCI_CLKMUXSTATUSREG_TLCLKSEL_STATUS_SHIFT		1
122 #define PRCI_CLKMUXSTATUSREG_TLCLKSEL_STATUS_MASK			\
123 		(0x1 << PRCI_CLKMUXSTATUSREG_TLCLKSEL_STATUS_SHIFT)
124 
125 /* CLTXPLLCFG0 */
126 #define PRCI_CLTXPLLCFG0_OFFSET		0x30
127 #define PRCI_CLTXPLLCFG0_DIVR_SHIFT	0
128 #define PRCI_CLTXPLLCFG0_DIVR_MASK	(0x3f << PRCI_CLTXPLLCFG0_DIVR_SHIFT)
129 #define PRCI_CLTXPLLCFG0_DIVF_SHIFT	6
130 #define PRCI_CLTXPLLCFG0_DIVF_MASK	(0x1ff << PRCI_CLTXPLLCFG0_DIVF_SHIFT)
131 #define PRCI_CLTXPLLCFG0_DIVQ_SHIFT	15
132 #define PRCI_CLTXPLLCFG0_DIVQ_MASK	(0x7 << PRCI_CLTXPLLCFG0_DIVQ_SHIFT)
133 #define PRCI_CLTXPLLCFG0_RANGE_SHIFT	18
134 #define PRCI_CLTXPLLCFG0_RANGE_MASK	(0x7 << PRCI_CLTXPLLCFG0_RANGE_SHIFT)
135 #define PRCI_CLTXPLLCFG0_BYPASS_SHIFT	24
136 #define PRCI_CLTXPLLCFG0_BYPASS_MASK	(0x1 << PRCI_CLTXPLLCFG0_BYPASS_SHIFT)
137 #define PRCI_CLTXPLLCFG0_FSE_SHIFT	25
138 #define PRCI_CLTXPLLCFG0_FSE_MASK	(0x1 << PRCI_CLTXPLLCFG0_FSE_SHIFT)
139 #define PRCI_CLTXPLLCFG0_LOCK_SHIFT	31
140 #define PRCI_CLTXPLLCFG0_LOCK_MASK	(0x1 << PRCI_CLTXPLLCFG0_LOCK_SHIFT)
141 
142 /* CLTXPLLCFG1 */
143 #define PRCI_CLTXPLLCFG1_OFFSET		0x34
144 #define PRCI_CLTXPLLCFG1_CKE_SHIFT	31
145 #define PRCI_CLTXPLLCFG1_CKE_MASK	(0x1 << PRCI_CLTXPLLCFG1_CKE_SHIFT)
146 
147 /* DVFSCOREPLLCFG0 */
148 #define PRCI_DVFSCOREPLLCFG0_OFFSET	0x38
149 
150 /* DVFSCOREPLLCFG1 */
151 #define PRCI_DVFSCOREPLLCFG1_OFFSET	0x3c
152 #define PRCI_DVFSCOREPLLCFG1_CKE_SHIFT	31
153 #define PRCI_DVFSCOREPLLCFG1_CKE_MASK	(0x1 << PRCI_DVFSCOREPLLCFG1_CKE_SHIFT)
154 
155 /* COREPLLSEL */
156 #define PRCI_COREPLLSEL_OFFSET			0x40
157 #define PRCI_COREPLLSEL_COREPLLSEL_SHIFT	0
158 #define PRCI_COREPLLSEL_COREPLLSEL_MASK					\
159 		(0x1 << PRCI_COREPLLSEL_COREPLLSEL_SHIFT)
160 
161 /* HFPCLKPLLCFG0 */
162 #define PRCI_HFPCLKPLLCFG0_OFFSET		0x50
163 #define PRCI_HFPCLKPLL_CFG0_DIVR_SHIFT		0
164 #define PRCI_HFPCLKPLL_CFG0_DIVR_MASK					\
165 		(0x3f << PRCI_HFPCLKPLLCFG0_DIVR_SHIFT)
166 #define PRCI_HFPCLKPLL_CFG0_DIVF_SHIFT		6
167 #define PRCI_HFPCLKPLL_CFG0_DIVF_MASK					\
168 		(0x1ff << PRCI_HFPCLKPLLCFG0_DIVF_SHIFT)
169 #define PRCI_HFPCLKPLL_CFG0_DIVQ_SHIFT		15
170 #define PRCI_HFPCLKPLL_CFG0_DIVQ_MASK					\
171 		(0x7 << PRCI_HFPCLKPLLCFG0_DIVQ_SHIFT)
172 #define PRCI_HFPCLKPLL_CFG0_RANGE_SHIFT		18
173 #define PRCI_HFPCLKPLL_CFG0_RANGE_MASK					\
174 		(0x7 << PRCI_HFPCLKPLLCFG0_RANGE_SHIFT)
175 #define PRCI_HFPCLKPLL_CFG0_BYPASS_SHIFT	24
176 #define PRCI_HFPCLKPLL_CFG0_BYPASS_MASK					\
177 		(0x1 << PRCI_HFPCLKPLLCFG0_BYPASS_SHIFT)
178 #define PRCI_HFPCLKPLL_CFG0_FSE_SHIFT		25
179 #define PRCI_HFPCLKPLL_CFG0_FSE_MASK					\
180 		(0x1 << PRCI_HFPCLKPLLCFG0_FSE_SHIFT)
181 #define PRCI_HFPCLKPLL_CFG0_LOCK_SHIFT		31
182 #define PRCI_HFPCLKPLL_CFG0_LOCK_MASK					\
183 		(0x1 << PRCI_HFPCLKPLLCFG0_LOCK_SHIFT)
184 
185 /* HFPCLKPLLCFG1 */
186 #define PRCI_HFPCLKPLLCFG1_OFFSET		0x54
187 #define PRCI_HFPCLKPLLCFG1_CKE_SHIFT		31
188 #define PRCI_HFPCLKPLLCFG1_CKE_MASK					\
189 		(0x1 << PRCI_HFPCLKPLLCFG1_CKE_SHIFT)
190 
191 /* HFPCLKPLLSEL */
192 #define PRCI_HFPCLKPLLSEL_OFFSET		0x58
193 #define PRCI_HFPCLKPLLSEL_HFPCLKPLLSEL_SHIFT	0
194 #define PRCI_HFPCLKPLLSEL_HFPCLKPLLSEL_MASK				\
195 		(0x1 << PRCI_HFPCLKPLLSEL_HFPCLKPLLSEL_SHIFT)
196 
197 /* HFPCLKPLLDIV */
198 #define PRCI_HFPCLKPLLDIV_OFFSET		0x5c
199 
200 /* PRCIPLL */
201 #define PRCI_PRCIPLL_OFFSET			0xe0
202 
203 /* PROCMONCFG */
204 #define PRCI_PROCMONCFG_OFFSET			0xf0
205 
206 /*
207  * Private structures
208  */
209 
210 /**
211  * struct __prci_data - per-device-instance data
212  * @va: base virtual address of the PRCI IP block
213  * @hw_clks: encapsulates struct clk_hw records
214  *
215  * PRCI per-device instance data
216  */
217 struct __prci_data {
218 	void __iomem *va;
219 	struct clk_hw_onecell_data hw_clks;
220 };
221 
222 /**
223  * struct __prci_wrpll_data - WRPLL configuration and integration data
224  * @c: WRPLL current configuration record
225  * @enable_bypass: fn ptr to code to bypass the WRPLL (if applicable; else NULL)
226  * @disable_bypass: fn ptr to code to not bypass the WRPLL (or NULL)
227  * @cfg0_offs: WRPLL CFG0 register offset (in bytes) from the PRCI base address
228  * @cfg1_offs: WRPLL CFG1 register offset (in bytes) from the PRCI base address
229  *
230  * @enable_bypass and @disable_bypass are used for WRPLL instances
231  * that contain a separate external glitchless clock mux downstream
232  * from the PLL.  The WRPLL internal bypass mux is not glitchless.
233  */
234 struct __prci_wrpll_data {
235 	struct wrpll_cfg c;
236 	void (*enable_bypass)(struct __prci_data *pd);
237 	void (*disable_bypass)(struct __prci_data *pd);
238 	u8 cfg0_offs;
239 	u8 cfg1_offs;
240 };
241 
242 /**
243  * struct __prci_clock - describes a clock device managed by PRCI
244  * @name: user-readable clock name string - should match the manual
245  * @parent_name: parent name for this clock
246  * @ops: struct clk_ops for the Linux clock framework to use for control
247  * @hw: Linux-private clock data
248  * @pwd: WRPLL-specific data, associated with this clock (if not NULL)
249  * @pd: PRCI-specific data associated with this clock (if not NULL)
250  *
251  * PRCI clock data.  Used by the PRCI driver to register PRCI-provided
252  * clocks to the Linux clock infrastructure.
253  */
254 struct __prci_clock {
255 	const char *name;
256 	const char *parent_name;
257 	const struct clk_ops *ops;
258 	struct clk_hw hw;
259 	struct __prci_wrpll_data *pwd;
260 	struct __prci_data *pd;
261 };
262 
263 #define clk_hw_to_prci_clock(pwd) container_of(pwd, struct __prci_clock, hw)
264 
265 /*
266  * struct prci_clk_desc - describes the information of clocks of each SoCs
267  * @clks: point to a array of __prci_clock
268  * @num_clks: the number of element of clks
269  */
270 struct prci_clk_desc {
271 	struct __prci_clock *clks;
272 	size_t num_clks;
273 };
274 
275 /* Core clock mux control */
276 void sifive_prci_coreclksel_use_hfclk(struct __prci_data *pd);
277 void sifive_prci_coreclksel_use_corepll(struct __prci_data *pd);
278 void sifive_prci_coreclksel_use_final_corepll(struct __prci_data *pd);
279 void sifive_prci_corepllsel_use_dvfscorepll(struct __prci_data *pd);
280 void sifive_prci_corepllsel_use_corepll(struct __prci_data *pd);
281 void sifive_prci_hfpclkpllsel_use_hfclk(struct __prci_data *pd);
282 void sifive_prci_hfpclkpllsel_use_hfpclkpll(struct __prci_data *pd);
283 
284 /* Linux clock framework integration */
285 long sifive_prci_wrpll_round_rate(struct clk_hw *hw, unsigned long rate,
286 				  unsigned long *parent_rate);
287 int sifive_prci_wrpll_set_rate(struct clk_hw *hw, unsigned long rate,
288 			       unsigned long parent_rate);
289 int sifive_clk_is_enabled(struct clk_hw *hw);
290 int sifive_prci_clock_enable(struct clk_hw *hw);
291 void sifive_prci_clock_disable(struct clk_hw *hw);
292 unsigned long sifive_prci_wrpll_recalc_rate(struct clk_hw *hw,
293 					    unsigned long parent_rate);
294 unsigned long sifive_prci_tlclksel_recalc_rate(struct clk_hw *hw,
295 					       unsigned long parent_rate);
296 unsigned long sifive_prci_hfpclkplldiv_recalc_rate(struct clk_hw *hw,
297 						   unsigned long parent_rate);
298 
299 #endif /* __SIFIVE_CLK_SIFIVE_PRCI_H */
300