xref: /openbmc/u-boot/drivers/misc/mxs_ocotp.c (revision 75504e95)
1 /*
2  * Freescale i.MX28 OCOTP Driver
3  *
4  * Copyright (C) 2014 Marek Vasut <marex@denx.de>
5  *
6  * SPDX-License-Identifier:	GPL-2.0+
7  *
8  * Note: The i.MX23/i.MX28 OCOTP block is a predecessor to the OCOTP block
9  *       used in i.MX6 . While these blocks are very similar at the first
10  *       glance, by digging deeper, one will notice differences (like the
11  *       tight dependence on MXS power block, some completely new registers
12  *       etc.) which would make common driver an ifdef nightmare :-(
13  */
14 
15 #include <common.h>
16 #include <fuse.h>
17 #include <asm/errno.h>
18 #include <asm/io.h>
19 #include <asm/arch/clock.h>
20 #include <asm/arch/imx-regs.h>
21 #include <asm/arch/sys_proto.h>
22 
23 #define MXS_OCOTP_TIMEOUT	100000
24 
25 static struct mxs_ocotp_regs *ocotp_regs =
26 	(struct mxs_ocotp_regs *)MXS_OCOTP_BASE;
27 static struct mxs_power_regs *power_regs =
28 	(struct mxs_power_regs *)MXS_POWER_BASE;
29 static struct mxs_clkctrl_regs *clkctrl_regs =
30 	(struct mxs_clkctrl_regs *)MXS_CLKCTRL_BASE;
31 
32 static int mxs_ocotp_wait_busy_clear(void)
33 {
34 	uint32_t reg;
35 	int timeout = MXS_OCOTP_TIMEOUT;
36 
37 	while (--timeout) {
38 		reg = readl(&ocotp_regs->hw_ocotp_ctrl);
39 		if (!(reg & OCOTP_CTRL_BUSY))
40 			break;
41 		udelay(10);
42 	}
43 
44 	if (!timeout)
45 		return -EINVAL;
46 
47 	/* Wait a little as per FSL datasheet's 'write postamble' section. */
48 	udelay(10);
49 
50 	return 0;
51 }
52 
53 static void mxs_ocotp_clear_error(void)
54 {
55 	writel(OCOTP_CTRL_ERROR, &ocotp_regs->hw_ocotp_ctrl_clr);
56 }
57 
58 static int mxs_ocotp_read_bank_open(bool open)
59 {
60 	int ret = 0;
61 
62 	if (open) {
63 		writel(OCOTP_CTRL_RD_BANK_OPEN,
64 		       &ocotp_regs->hw_ocotp_ctrl_set);
65 
66 		/*
67 		 * Wait before polling the BUSY bit, since the BUSY bit might
68 		 * be asserted only after a few HCLK cycles and if we were to
69 		 * poll immediatelly, we could miss the busy bit.
70 		 */
71 		udelay(10);
72 		ret = mxs_ocotp_wait_busy_clear();
73 	} else {
74 		writel(OCOTP_CTRL_RD_BANK_OPEN,
75 		       &ocotp_regs->hw_ocotp_ctrl_clr);
76 	}
77 
78 	return ret;
79 }
80 
81 static void mxs_ocotp_scale_vddio(bool enter, uint32_t *val)
82 {
83 	uint32_t scale_val;
84 
85 	if (enter) {
86 		/*
87 		 * Enter the fuse programming VDDIO voltage setup. We start
88 		 * scaling the voltage from it's current value down to 2.8V
89 		 * which is the one and only correct voltage for programming
90 		 * the OCOTP fuses (according to datasheet).
91 		 */
92 		scale_val = readl(&power_regs->hw_power_vddioctrl);
93 		scale_val &= POWER_VDDIOCTRL_TRG_MASK;
94 
95 		/* Return the original voltage. */
96 		*val = scale_val;
97 
98 		/*
99 		 * Start scaling VDDIO down to 0x2, which is 2.8V . Actually,
100 		 * the value 0x0 should be 2.8V, but that's not the case on
101 		 * most designs due to load etc., so we play safe. Undervolt
102 		 * can actually cause incorrect programming of the fuses and
103 		 * or reboots of the board.
104 		 */
105 		while (scale_val > 2) {
106 			clrsetbits_le32(&power_regs->hw_power_vddioctrl,
107 					POWER_VDDIOCTRL_TRG_MASK, --scale_val);
108 			udelay(500);
109 		}
110 	} else {
111 		/* Start scaling VDDIO up to original value . */
112 		for (scale_val = 2; scale_val <= *val; scale_val++) {
113 			clrsetbits_le32(&power_regs->hw_power_vddioctrl,
114 					POWER_VDDIOCTRL_TRG_MASK, scale_val);
115 			udelay(500);
116 		}
117 	}
118 
119 	mdelay(10);
120 }
121 
122 static int mxs_ocotp_wait_hclk_ready(void)
123 {
124 	uint32_t reg, timeout = MXS_OCOTP_TIMEOUT;
125 
126 	while (--timeout) {
127 		reg = readl(&clkctrl_regs->hw_clkctrl_hbus);
128 		if (!(reg & CLKCTRL_HBUS_ASM_BUSY))
129 			break;
130 	}
131 
132 	if (!timeout)
133 		return -EINVAL;
134 
135 	return 0;
136 }
137 
138 static int mxs_ocotp_scale_hclk(bool enter, uint32_t *val)
139 {
140 	uint32_t scale_val;
141 	int ret;
142 
143 	ret = mxs_ocotp_wait_hclk_ready();
144 	if (ret)
145 		return ret;
146 
147 	/* Set CPU bypass */
148 	writel(CLKCTRL_CLKSEQ_BYPASS_CPU,
149 	       &clkctrl_regs->hw_clkctrl_clkseq_set);
150 
151 	if (enter) {
152 		/* Return the original HCLK clock speed. */
153 		*val = readl(&clkctrl_regs->hw_clkctrl_hbus);
154 		*val &= CLKCTRL_HBUS_DIV_MASK;
155 
156 		/* Scale the HCLK to 454/19 = 23.9 MHz . */
157 		scale_val = (~19) << CLKCTRL_HBUS_DIV_OFFSET;
158 		scale_val &= CLKCTRL_HBUS_DIV_MASK;
159 	} else {
160 		/* Scale the HCLK back to original frequency. */
161 		scale_val = (~(*val)) << CLKCTRL_HBUS_DIV_OFFSET;
162 		scale_val &= CLKCTRL_HBUS_DIV_MASK;
163 	}
164 
165 	writel(CLKCTRL_HBUS_DIV_MASK,
166 	       &clkctrl_regs->hw_clkctrl_hbus_set);
167 	writel(scale_val,
168 	       &clkctrl_regs->hw_clkctrl_hbus_clr);
169 
170 	mdelay(10);
171 
172 	ret = mxs_ocotp_wait_hclk_ready();
173 	if (ret)
174 		return ret;
175 
176 	/* Disable CPU bypass */
177 	writel(CLKCTRL_CLKSEQ_BYPASS_CPU,
178 	       &clkctrl_regs->hw_clkctrl_clkseq_clr);
179 
180 	mdelay(10);
181 
182 	return 0;
183 }
184 
185 static int mxs_ocotp_write_fuse(uint32_t addr, uint32_t mask)
186 {
187 	uint32_t hclk_val, vddio_val;
188 	int ret;
189 
190 	/* Make sure the banks are closed for reading. */
191 	ret = mxs_ocotp_read_bank_open(0);
192 	if (ret) {
193 		puts("Failed closing banks for reading!\n");
194 		return ret;
195 	}
196 
197 	ret = mxs_ocotp_scale_hclk(1, &hclk_val);
198 	if (ret) {
199 		puts("Failed scaling down the HCLK!\n");
200 		return ret;
201 	}
202 	mxs_ocotp_scale_vddio(1, &vddio_val);
203 
204 	ret = mxs_ocotp_wait_busy_clear();
205 	if (ret) {
206 		puts("Failed waiting for ready state!\n");
207 		goto fail;
208 	}
209 
210 	/* Program the fuse address */
211 	writel(addr | OCOTP_CTRL_WR_UNLOCK_KEY, &ocotp_regs->hw_ocotp_ctrl);
212 
213 	/* Program the data. */
214 	writel(mask, &ocotp_regs->hw_ocotp_data);
215 
216 	udelay(10);
217 
218 	ret = mxs_ocotp_wait_busy_clear();
219 	if (ret) {
220 		puts("Failed waiting for ready state!\n");
221 		goto fail;
222 	}
223 
224 fail:
225 	mxs_ocotp_scale_vddio(0, &vddio_val);
226 	ret = mxs_ocotp_scale_hclk(0, &hclk_val);
227 	if (ret) {
228 		puts("Failed scaling up the HCLK!\n");
229 		return ret;
230 	}
231 
232 	return ret;
233 }
234 
235 static int mxs_ocotp_read_fuse(uint32_t reg, uint32_t *val)
236 {
237 	int ret;
238 
239 	/* Register offset from CUST0 */
240 	reg = ((uint32_t)&ocotp_regs->hw_ocotp_cust0) + (reg << 4);
241 
242 	ret = mxs_ocotp_wait_busy_clear();
243 	if (ret) {
244 		puts("Failed waiting for ready state!\n");
245 		return ret;
246 	}
247 
248 	mxs_ocotp_clear_error();
249 
250 	ret = mxs_ocotp_read_bank_open(1);
251 	if (ret) {
252 		puts("Failed opening banks for reading!\n");
253 		return ret;
254 	}
255 
256 	*val = readl(reg);
257 
258 	ret = mxs_ocotp_read_bank_open(0);
259 	if (ret) {
260 		puts("Failed closing banks for reading!\n");
261 		return ret;
262 	}
263 
264 	return ret;
265 }
266 
267 static int mxs_ocotp_valid(u32 bank, u32 word)
268 {
269 	if (bank > 4)
270 		return -EINVAL;
271 	if (word > 7)
272 		return -EINVAL;
273 	return 0;
274 }
275 
276 /*
277  * The 'fuse' command API
278  */
279 int fuse_read(u32 bank, u32 word, u32 *val)
280 {
281 	int ret;
282 
283 	ret = mxs_ocotp_valid(bank, word);
284 	if (ret)
285 		return ret;
286 
287 	return mxs_ocotp_read_fuse((bank << 3) | word, val);
288 }
289 
290 int fuse_prog(u32 bank, u32 word, u32 val)
291 {
292 	int ret;
293 
294 	ret = mxs_ocotp_valid(bank, word);
295 	if (ret)
296 		return ret;
297 
298 	return mxs_ocotp_write_fuse((bank << 3) | word, val);
299 }
300 
301 int fuse_sense(u32 bank, u32 word, u32 *val)
302 {
303 	/* We do not support sensing :-( */
304 	return -EINVAL;
305 }
306 
307 int fuse_override(u32 bank, u32 word, u32 val)
308 {
309 	/* We do not support overriding :-( */
310 	return -EINVAL;
311 }
312