xref: /openbmc/u-boot/drivers/i2c/fsl_i2c.c (revision ec2c81c5)
1 /*
2  * Copyright 2006,2009 Freescale Semiconductor, Inc.
3  *
4  * 2012, Heiko Schocher, DENX Software Engineering, hs@denx.de.
5  * Changes for multibus/multiadapter I2C support.
6  *
7  * SPDX-License-Identifier:	GPL-2.0
8  */
9 
10 #include <common.h>
11 #include <command.h>
12 #include <i2c.h>		/* Functional interface */
13 #include <asm/io.h>
14 #include <asm/fsl_i2c.h>	/* HW definitions */
15 
16 /* The maximum number of microseconds we will wait until another master has
17  * released the bus.  If not defined in the board header file, then use a
18  * generic value.
19  */
20 #ifndef CONFIG_I2C_MBB_TIMEOUT
21 #define CONFIG_I2C_MBB_TIMEOUT	100000
22 #endif
23 
24 /* The maximum number of microseconds we will wait for a read or write
25  * operation to complete.  If not defined in the board header file, then use a
26  * generic value.
27  */
28 #ifndef CONFIG_I2C_TIMEOUT
29 #define CONFIG_I2C_TIMEOUT	100000
30 #endif
31 
32 #define I2C_READ_BIT  1
33 #define I2C_WRITE_BIT 0
34 
35 DECLARE_GLOBAL_DATA_PTR;
36 
37 static const struct fsl_i2c_base *i2c_base[4] = {
38 	(struct fsl_i2c_base *)(CONFIG_SYS_IMMR + CONFIG_SYS_FSL_I2C_OFFSET),
39 #ifdef CONFIG_SYS_FSL_I2C2_OFFSET
40 	(struct fsl_i2c_base *)(CONFIG_SYS_IMMR + CONFIG_SYS_FSL_I2C2_OFFSET),
41 #endif
42 #ifdef CONFIG_SYS_FSL_I2C3_OFFSET
43 	(struct fsl_i2c_base *)(CONFIG_SYS_IMMR + CONFIG_SYS_FSL_I2C3_OFFSET),
44 #endif
45 #ifdef CONFIG_SYS_FSL_I2C4_OFFSET
46 	(struct fsl_i2c_base *)(CONFIG_SYS_IMMR + CONFIG_SYS_FSL_I2C4_OFFSET)
47 #endif
48 };
49 
50 /* I2C speed map for a DFSR value of 1 */
51 
52 /*
53  * Map I2C frequency dividers to FDR and DFSR values
54  *
55  * This structure is used to define the elements of a table that maps I2C
56  * frequency divider (I2C clock rate divided by I2C bus speed) to a value to be
57  * programmed into the Frequency Divider Ratio (FDR) and Digital Filter
58  * Sampling Rate (DFSR) registers.
59  *
60  * The actual table should be defined in the board file, and it must be called
61  * fsl_i2c_speed_map[].
62  *
63  * The last entry of the table must have a value of {-1, X}, where X is same
64  * FDR/DFSR values as the second-to-last entry.  This guarantees that any
65  * search through the array will always find a match.
66  *
67  * The values of the divider must be in increasing numerical order, i.e.
68  * fsl_i2c_speed_map[x+1].divider > fsl_i2c_speed_map[x].divider.
69  *
70  * For this table, the values are based on a value of 1 for the DFSR
71  * register.  See the application note AN2919 "Determining the I2C Frequency
72  * Divider Ratio for SCL"
73  *
74  * ColdFire I2C frequency dividers for FDR values are different from
75  * PowerPC. The protocol to use the I2C module is still the same.
76  * A different table is defined and are based on MCF5xxx user manual.
77  *
78  */
79 static const struct {
80 	unsigned short divider;
81 	u8 fdr;
82 } fsl_i2c_speed_map[] = {
83 #ifdef __M68K__
84 	{20, 32}, {22, 33}, {24, 34}, {26, 35},
85 	{28, 0}, {28, 36}, {30, 1}, {32, 37},
86 	{34, 2}, {36, 38}, {40, 3}, {40, 39},
87 	{44, 4}, {48, 5}, {48, 40}, {56, 6},
88 	{56, 41}, {64, 42}, {68, 7}, {72, 43},
89 	{80, 8}, {80, 44}, {88, 9}, {96, 41},
90 	{104, 10}, {112, 42}, {128, 11}, {128, 43},
91 	{144, 12}, {160, 13}, {160, 48}, {192, 14},
92 	{192, 49}, {224, 50}, {240, 15}, {256, 51},
93 	{288, 16}, {320, 17}, {320, 52}, {384, 18},
94 	{384, 53}, {448, 54}, {480, 19}, {512, 55},
95 	{576, 20}, {640, 21}, {640, 56}, {768, 22},
96 	{768, 57}, {960, 23}, {896, 58}, {1024, 59},
97 	{1152, 24}, {1280, 25}, {1280, 60}, {1536, 26},
98 	{1536, 61}, {1792, 62}, {1920, 27}, {2048, 63},
99 	{2304, 28}, {2560, 29}, {3072, 30}, {3840, 31},
100 	{-1, 31}
101 #endif
102 };
103 
104 /**
105  * Set the I2C bus speed for a given I2C device
106  *
107  * @param base: the I2C device registers
108  * @i2c_clk: I2C bus clock frequency
109  * @speed: the desired speed of the bus
110  *
111  * The I2C device must be stopped before calling this function.
112  *
113  * The return value is the actual bus speed that is set.
114  */
115 static unsigned int set_i2c_bus_speed(const struct fsl_i2c_base *base,
116 	unsigned int i2c_clk, unsigned int speed)
117 {
118 	unsigned short divider = min(i2c_clk / speed, (unsigned int)USHRT_MAX);
119 
120 	/*
121 	 * We want to choose an FDR/DFSR that generates an I2C bus speed that
122 	 * is equal to or lower than the requested speed.  That means that we
123 	 * want the first divider that is equal to or greater than the
124 	 * calculated divider.
125 	 */
126 #ifdef __PPC__
127 	u8 dfsr, fdr = 0x31; /* Default if no FDR found */
128 	/* a, b and dfsr matches identifiers A,B and C respectively in AN2919 */
129 	unsigned short a, b, ga, gb;
130 	unsigned long c_div, est_div;
131 
132 #ifdef CONFIG_FSL_I2C_CUSTOM_DFSR
133 	dfsr = CONFIG_FSL_I2C_CUSTOM_DFSR;
134 #else
135 	/* Condition 1: dfsr <= 50/T */
136 	dfsr = (5 * (i2c_clk / 1000)) / 100000;
137 #endif
138 #ifdef CONFIG_FSL_I2C_CUSTOM_FDR
139 	fdr = CONFIG_FSL_I2C_CUSTOM_FDR;
140 	speed = i2c_clk / divider; /* Fake something */
141 #else
142 	debug("Requested speed:%d, i2c_clk:%d\n", speed, i2c_clk);
143 	if (!dfsr)
144 		dfsr = 1;
145 
146 	est_div = ~0;
147 	for (ga = 0x4, a = 10; a <= 30; ga++, a += 2) {
148 		for (gb = 0; gb < 8; gb++) {
149 			b = 16 << gb;
150 			c_div = b * (a + ((3*dfsr)/b)*2);
151 			if ((c_div > divider) && (c_div < est_div)) {
152 				unsigned short bin_gb, bin_ga;
153 
154 				est_div = c_div;
155 				bin_gb = gb << 2;
156 				bin_ga = (ga & 0x3) | ((ga & 0x4) << 3);
157 				fdr = bin_gb | bin_ga;
158 				speed = i2c_clk / est_div;
159 				debug("FDR:0x%.2x, div:%ld, ga:0x%x, gb:0x%x, "
160 				      "a:%d, b:%d, speed:%d\n",
161 				      fdr, est_div, ga, gb, a, b, speed);
162 				/* Condition 2 not accounted for */
163 				debug("Tr <= %d ns\n",
164 				      (b - 3 * dfsr) * 1000000 /
165 				      (i2c_clk / 1000));
166 			}
167 		}
168 		if (a == 20)
169 			a += 2;
170 		if (a == 24)
171 			a += 4;
172 	}
173 	debug("divider:%d, est_div:%ld, DFSR:%d\n", divider, est_div, dfsr);
174 	debug("FDR:0x%.2x, speed:%d\n", fdr, speed);
175 #endif
176 	writeb(dfsr, &base->dfsrr);	/* set default filter */
177 	writeb(fdr, &base->fdr);	/* set bus speed */
178 #else
179 	unsigned int i;
180 
181 	for (i = 0; i < ARRAY_SIZE(fsl_i2c_speed_map); i++)
182 		if (fsl_i2c_speed_map[i].divider >= divider) {
183 			u8 fdr;
184 
185 			fdr = fsl_i2c_speed_map[i].fdr;
186 			speed = i2c_clk / fsl_i2c_speed_map[i].divider;
187 			writeb(fdr, &base->fdr);	/* set bus speed */
188 
189 			break;
190 		}
191 #endif
192 	return speed;
193 }
194 
195 static unsigned int get_i2c_clock(int bus)
196 {
197 	if (bus)
198 		return gd->arch.i2c2_clk;	/* I2C2 clock */
199 	else
200 		return gd->arch.i2c1_clk;	/* I2C1 clock */
201 }
202 
203 static int fsl_i2c_fixup(const struct fsl_i2c_base *base)
204 {
205 	const unsigned long long timeout = usec2ticks(CONFIG_I2C_MBB_TIMEOUT);
206 	unsigned long long timeval = 0;
207 	int ret = -1;
208 	unsigned int flags = 0;
209 
210 #ifdef CONFIG_SYS_FSL_ERRATUM_I2C_A004447
211 	unsigned int svr = get_svr();
212 	if ((SVR_SOC_VER(svr) == SVR_8548 && IS_SVR_REV(svr, 3, 1)) ||
213 	    (SVR_REV(svr) <= CONFIG_SYS_FSL_A004447_SVR_REV))
214 		flags = I2C_CR_BIT6;
215 #endif
216 
217 	writeb(I2C_CR_MEN | I2C_CR_MSTA, &base->cr);
218 
219 	timeval = get_ticks();
220 	while (!(readb(&base->sr) & I2C_SR_MBB)) {
221 		if ((get_ticks() - timeval) > timeout)
222 			goto err;
223 	}
224 
225 	if (readb(&base->sr) & I2C_SR_MAL) {
226 		/* SDA is stuck low */
227 		writeb(0, &base->cr);
228 		udelay(100);
229 		writeb(I2C_CR_MSTA | flags, &base->cr);
230 		writeb(I2C_CR_MEN | I2C_CR_MSTA | flags, &base->cr);
231 	}
232 
233 	readb(&base->dr);
234 
235 	timeval = get_ticks();
236 	while (!(readb(&base->sr) & I2C_SR_MIF)) {
237 		if ((get_ticks() - timeval) > timeout)
238 			goto err;
239 	}
240 	ret = 0;
241 
242 err:
243 	writeb(I2C_CR_MEN | flags, &base->cr);
244 	writeb(0, &base->sr);
245 	udelay(100);
246 
247 	return ret;
248 }
249 
250 static void fsl_i2c_init(struct i2c_adapter *adap, int speed, int slaveadd)
251 {
252 	const struct fsl_i2c_base *base;
253 	const unsigned long long timeout = usec2ticks(CONFIG_I2C_MBB_TIMEOUT);
254 	unsigned long long timeval;
255 
256 #ifdef CONFIG_SYS_I2C_INIT_BOARD
257 	/* Call board specific i2c bus reset routine before accessing the
258 	 * environment, which might be in a chip on that bus. For details
259 	 * about this problem see doc/I2C_Edge_Conditions.
260 	*/
261 	i2c_init_board();
262 #endif
263 	base = (struct fsl_i2c_base *)i2c_base[adap->hwadapnr];
264 
265 	writeb(0, &base->cr);		/* stop I2C controller */
266 	udelay(5);			/* let it shutdown in peace */
267 	set_i2c_bus_speed(base, get_i2c_clock(adap->hwadapnr), speed);
268 	writeb(slaveadd << 1, &base->adr);/* write slave address */
269 	writeb(0x0, &base->sr);		/* clear status register */
270 	writeb(I2C_CR_MEN, &base->cr);	/* start I2C controller */
271 
272 	timeval = get_ticks();
273 	while (readb(&base->sr) & I2C_SR_MBB) {
274 		if ((get_ticks() - timeval) < timeout)
275 			continue;
276 
277 		if (fsl_i2c_fixup(base))
278 			debug("i2c_init: BUS#%d failed to init\n",
279 			      adap->hwadapnr);
280 
281 		break;
282 	}
283 
284 #ifdef CONFIG_SYS_I2C_BOARD_LATE_INIT
285 	/* Call board specific i2c bus reset routine AFTER the bus has been
286 	 * initialized. Use either this callpoint or i2c_init_board;
287 	 * which is called before i2c_init operations.
288 	 * For details about this problem see doc/I2C_Edge_Conditions.
289 	*/
290 	i2c_board_late_init();
291 #endif
292 }
293 
294 static int
295 i2c_wait4bus(struct i2c_adapter *adap)
296 {
297 	struct fsl_i2c_base *base =
298 		(struct fsl_i2c_base *)i2c_base[adap->hwadapnr];
299 	unsigned long long timeval = get_ticks();
300 	const unsigned long long timeout = usec2ticks(CONFIG_I2C_MBB_TIMEOUT);
301 
302 	while (readb(&base->sr) & I2C_SR_MBB) {
303 		if ((get_ticks() - timeval) > timeout)
304 			return -1;
305 	}
306 
307 	return 0;
308 }
309 
310 static __inline__ int
311 i2c_wait(struct i2c_adapter *adap, int write)
312 {
313 	u32 csr;
314 	unsigned long long timeval = get_ticks();
315 	const unsigned long long timeout = usec2ticks(CONFIG_I2C_TIMEOUT);
316 	struct fsl_i2c_base *base =
317 		(struct fsl_i2c_base *)i2c_base[adap->hwadapnr];
318 
319 	do {
320 		csr = readb(&base->sr);
321 		if (!(csr & I2C_SR_MIF))
322 			continue;
323 		/* Read again to allow register to stabilise */
324 		csr = readb(&base->sr);
325 
326 		writeb(0x0, &base->sr);
327 
328 		if (csr & I2C_SR_MAL) {
329 			debug("i2c_wait: MAL\n");
330 			return -1;
331 		}
332 
333 		if (!(csr & I2C_SR_MCF))	{
334 			debug("i2c_wait: unfinished\n");
335 			return -1;
336 		}
337 
338 		if (write == I2C_WRITE_BIT && (csr & I2C_SR_RXAK)) {
339 			debug("i2c_wait: No RXACK\n");
340 			return -1;
341 		}
342 
343 		return 0;
344 	} while ((get_ticks() - timeval) < timeout);
345 
346 	debug("i2c_wait: timed out\n");
347 	return -1;
348 }
349 
350 static __inline__ int
351 i2c_write_addr(struct i2c_adapter *adap, u8 dev, u8 dir, int rsta)
352 {
353 	struct fsl_i2c_base *base =
354 		(struct fsl_i2c_base *)i2c_base[adap->hwadapnr];
355 
356 	writeb(I2C_CR_MEN | I2C_CR_MSTA | I2C_CR_MTX
357 	       | (rsta ? I2C_CR_RSTA : 0),
358 	       &base->cr);
359 
360 	writeb((dev << 1) | dir, &base->dr);
361 
362 	if (i2c_wait(adap, I2C_WRITE_BIT) < 0)
363 		return 0;
364 
365 	return 1;
366 }
367 
368 static __inline__ int
369 __i2c_write(struct i2c_adapter *adap, u8 *data, int length)
370 {
371 	struct fsl_i2c_base *base =
372 		(struct fsl_i2c_base *)i2c_base[adap->hwadapnr];
373 	int i;
374 
375 	for (i = 0; i < length; i++) {
376 		writeb(data[i], &base->dr);
377 
378 		if (i2c_wait(adap, I2C_WRITE_BIT) < 0)
379 			break;
380 	}
381 
382 	return i;
383 }
384 
385 static __inline__ int
386 __i2c_read(struct i2c_adapter *adap, u8 *data, int length)
387 {
388 	struct fsl_i2c_base *base =
389 		(struct fsl_i2c_base *)i2c_base[adap->hwadapnr];
390 	int i;
391 
392 	writeb(I2C_CR_MEN | I2C_CR_MSTA | ((length == 1) ? I2C_CR_TXAK : 0),
393 	       &base->cr);
394 
395 	/* dummy read */
396 	readb(&base->dr);
397 
398 	for (i = 0; i < length; i++) {
399 		if (i2c_wait(adap, I2C_READ_BIT) < 0)
400 			break;
401 
402 		/* Generate ack on last next to last byte */
403 		if (i == length - 2)
404 			writeb(I2C_CR_MEN | I2C_CR_MSTA | I2C_CR_TXAK,
405 			       &base->cr);
406 
407 		/* Do not generate stop on last byte */
408 		if (i == length - 1)
409 			writeb(I2C_CR_MEN | I2C_CR_MSTA | I2C_CR_MTX,
410 			       &base->cr);
411 
412 		data[i] = readb(&base->dr);
413 	}
414 
415 	return i;
416 }
417 
418 static int
419 fsl_i2c_read(struct i2c_adapter *adap, u8 dev, uint addr, int alen, u8 *data,
420 	     int length)
421 {
422 	struct fsl_i2c_base *base =
423 		(struct fsl_i2c_base *)i2c_base[adap->hwadapnr];
424 	int i = -1; /* signal error */
425 	u8 *a = (u8*)&addr;
426 	int len = alen * -1;
427 
428 	if (i2c_wait4bus(adap) < 0)
429 		return -1;
430 
431 	/* To handle the need of I2C devices that require to write few bytes
432 	 * (more than 4 bytes of address as in the case of else part)
433 	 * of data before reading, Negative equivalent of length(bytes to write)
434 	 * is passed, but used the +ve part of len for writing data
435 	 */
436 	if (alen < 0) {
437 		/* Generate a START and send the Address and
438 		 * the Tx Bytes to the slave.
439 		 * "START: Address: Write bytes data[len]"
440 		 * IF part supports writing any number of bytes in contrast
441 		 * to the else part, which supports writing address offset
442 		 * of upto 4 bytes only.
443 		 * bytes that need to be written are passed in
444 		 * "data", which will eventually keep the data READ,
445 		 * after writing the len bytes out of it
446 		 */
447 		if (i2c_write_addr(adap, dev, I2C_WRITE_BIT, 0) != 0)
448 			i = __i2c_write(adap, data, len);
449 
450 		if (i != len)
451 			return -1;
452 
453 		if (length && i2c_write_addr(adap, dev, I2C_READ_BIT, 1) != 0)
454 			i = __i2c_read(adap, data, length);
455 	} else {
456 		if ((!length || alen > 0) &&
457 		    i2c_write_addr(adap, dev, I2C_WRITE_BIT, 0) != 0  &&
458 		    __i2c_write(adap, &a[4 - alen], alen) == alen)
459 			i = 0; /* No error so far */
460 
461 		if (length &&
462 		    i2c_write_addr(adap, dev, I2C_READ_BIT, alen ? 1 : 0) != 0)
463 			i = __i2c_read(adap, data, length);
464 	}
465 
466 	writeb(I2C_CR_MEN, &base->cr);
467 
468 	if (i2c_wait4bus(adap)) /* Wait until STOP */
469 		debug("i2c_read: wait4bus timed out\n");
470 
471 	if (i == length)
472 	    return 0;
473 
474 	return -1;
475 }
476 
477 static int
478 fsl_i2c_write(struct i2c_adapter *adap, u8 dev, uint addr, int alen,
479 	      u8 *data, int length)
480 {
481 	struct fsl_i2c_base *base =
482 		(struct fsl_i2c_base *)i2c_base[adap->hwadapnr];
483 	int i = -1; /* signal error */
484 	u8 *a = (u8*)&addr;
485 
486 	if (i2c_wait4bus(adap) < 0)
487 		return -1;
488 
489 	if (i2c_write_addr(adap, dev, I2C_WRITE_BIT, 0) != 0 &&
490 	    __i2c_write(adap, &a[4 - alen], alen) == alen) {
491 		i = __i2c_write(adap, data, length);
492 	}
493 
494 	writeb(I2C_CR_MEN, &base->cr);
495 	if (i2c_wait4bus(adap)) /* Wait until STOP */
496 		debug("i2c_write: wait4bus timed out\n");
497 
498 	if (i == length)
499 	    return 0;
500 
501 	return -1;
502 }
503 
504 static int
505 fsl_i2c_probe(struct i2c_adapter *adap, uchar chip)
506 {
507 	struct fsl_i2c_base *base =
508 		(struct fsl_i2c_base *)i2c_base[adap->hwadapnr];
509 	/* For unknow reason the controller will ACK when
510 	 * probing for a slave with the same address, so skip
511 	 * it.
512 	 */
513 	if (chip == (readb(&base->adr) >> 1))
514 		return -1;
515 
516 	return fsl_i2c_read(adap, chip, 0, 0, NULL, 0);
517 }
518 
519 static unsigned int fsl_i2c_set_bus_speed(struct i2c_adapter *adap,
520 			unsigned int speed)
521 {
522 	struct fsl_i2c_base *base =
523 		(struct fsl_i2c_base *)i2c_base[adap->hwadapnr];
524 
525 	writeb(0, &base->cr);		/* stop controller */
526 	set_i2c_bus_speed(base, get_i2c_clock(adap->hwadapnr), speed);
527 	writeb(I2C_CR_MEN, &base->cr);	/* start controller */
528 
529 	return 0;
530 }
531 
532 /*
533  * Register fsl i2c adapters
534  */
535 U_BOOT_I2C_ADAP_COMPLETE(fsl_0, fsl_i2c_init, fsl_i2c_probe, fsl_i2c_read,
536 			 fsl_i2c_write, fsl_i2c_set_bus_speed,
537 			 CONFIG_SYS_FSL_I2C_SPEED, CONFIG_SYS_FSL_I2C_SLAVE,
538 			 0)
539 #ifdef CONFIG_SYS_FSL_I2C2_OFFSET
540 U_BOOT_I2C_ADAP_COMPLETE(fsl_1, fsl_i2c_init, fsl_i2c_probe, fsl_i2c_read,
541 			 fsl_i2c_write, fsl_i2c_set_bus_speed,
542 			 CONFIG_SYS_FSL_I2C2_SPEED, CONFIG_SYS_FSL_I2C2_SLAVE,
543 			 1)
544 #endif
545 #ifdef CONFIG_SYS_FSL_I2C3_OFFSET
546 U_BOOT_I2C_ADAP_COMPLETE(fsl_2, fsl_i2c_init, fsl_i2c_probe, fsl_i2c_read,
547 			 fsl_i2c_write, fsl_i2c_set_bus_speed,
548 			 CONFIG_SYS_FSL_I2C3_SPEED, CONFIG_SYS_FSL_I2C3_SLAVE,
549 			 2)
550 #endif
551 #ifdef CONFIG_SYS_FSL_I2C4_OFFSET
552 U_BOOT_I2C_ADAP_COMPLETE(fsl_3, fsl_i2c_init, fsl_i2c_probe, fsl_i2c_read,
553 			 fsl_i2c_write, fsl_i2c_set_bus_speed,
554 			 CONFIG_SYS_FSL_I2C4_SPEED, CONFIG_SYS_FSL_I2C4_SLAVE,
555 			 3)
556 #endif
557