xref: /openbmc/u-boot/cmd/i2c.c (revision b9553986)
1 // SPDX-License-Identifier: GPL-2.0+
2 /*
3  * (C) Copyright 2009
4  * Sergey Kubushyn, himself, ksi@koi8.net
5  *
6  * Changes for unified multibus/multiadapter I2C support.
7  *
8  * (C) Copyright 2001
9  * Gerald Van Baren, Custom IDEAS, vanbaren@cideas.com.
10  */
11 
12 /*
13  * I2C Functions similar to the standard memory functions.
14  *
15  * There are several parameters in many of the commands that bear further
16  * explanations:
17  *
18  * {i2c_chip} is the I2C chip address (the first byte sent on the bus).
19  *   Each I2C chip on the bus has a unique address.  On the I2C data bus,
20  *   the address is the upper seven bits and the LSB is the "read/write"
21  *   bit.  Note that the {i2c_chip} address specified on the command
22  *   line is not shifted up: e.g. a typical EEPROM memory chip may have
23  *   an I2C address of 0x50, but the data put on the bus will be 0xA0
24  *   for write and 0xA1 for read.  This "non shifted" address notation
25  *   matches at least half of the data sheets :-/.
26  *
27  * {addr} is the address (or offset) within the chip.  Small memory
28  *   chips have 8 bit addresses.  Large memory chips have 16 bit
29  *   addresses.  Other memory chips have 9, 10, or 11 bit addresses.
30  *   Many non-memory chips have multiple registers and {addr} is used
31  *   as the register index.  Some non-memory chips have only one register
32  *   and therefore don't need any {addr} parameter.
33  *
34  *   The default {addr} parameter is one byte (.1) which works well for
35  *   memories and registers with 8 bits of address space.
36  *
37  *   You can specify the length of the {addr} field with the optional .0,
38  *   .1, or .2 modifier (similar to the .b, .w, .l modifier).  If you are
39  *   manipulating a single register device which doesn't use an address
40  *   field, use "0.0" for the address and the ".0" length field will
41  *   suppress the address in the I2C data stream.  This also works for
42  *   successive reads using the I2C auto-incrementing memory pointer.
43  *
44  *   If you are manipulating a large memory with 2-byte addresses, use
45  *   the .2 address modifier, e.g. 210.2 addresses location 528 (decimal).
46  *
47  *   Then there are the unfortunate memory chips that spill the most
48  *   significant 1, 2, or 3 bits of address into the chip address byte.
49  *   This effectively makes one chip (logically) look like 2, 4, or
50  *   8 chips.  This is handled (awkwardly) by #defining
51  *   CONFIG_SYS_I2C_EEPROM_ADDR_OVERFLOW and using the .1 modifier on the
52  *   {addr} field (since .1 is the default, it doesn't actually have to
53  *   be specified).  Examples: given a memory chip at I2C chip address
54  *   0x50, the following would happen...
55  *     i2c md 50 0 10   display 16 bytes starting at 0x000
56  *                      On the bus: <S> A0 00 <E> <S> A1 <rd> ... <rd>
57  *     i2c md 50 100 10 display 16 bytes starting at 0x100
58  *                      On the bus: <S> A2 00 <E> <S> A3 <rd> ... <rd>
59  *     i2c md 50 210 10 display 16 bytes starting at 0x210
60  *                      On the bus: <S> A4 10 <E> <S> A5 <rd> ... <rd>
61  *   This is awfully ugly.  It would be nice if someone would think up
62  *   a better way of handling this.
63  *
64  * Adapted from cmd_mem.c which is copyright Wolfgang Denk (wd@denx.de).
65  */
66 
67 #include <common.h>
68 #include <bootretry.h>
69 #include <cli.h>
70 #include <command.h>
71 #include <console.h>
72 #include <dm.h>
73 #include <edid.h>
74 #include <environment.h>
75 #include <errno.h>
76 #include <i2c.h>
77 #include <malloc.h>
78 #include <asm/byteorder.h>
79 #include <linux/compiler.h>
80 
81 /* Display values from last command.
82  * Memory modify remembered values are different from display memory.
83  */
84 static uint	i2c_dp_last_chip;
85 static uint	i2c_dp_last_addr;
86 static uint	i2c_dp_last_alen;
87 static uint	i2c_dp_last_length = 0x10;
88 
89 static uint	i2c_mm_last_chip;
90 static uint	i2c_mm_last_addr;
91 static uint	i2c_mm_last_alen;
92 
93 /* If only one I2C bus is present, the list of devices to ignore when
94  * the probe command is issued is represented by a 1D array of addresses.
95  * When multiple buses are present, the list is an array of bus-address
96  * pairs.  The following macros take care of this */
97 
98 #if defined(CONFIG_SYS_I2C_NOPROBES)
99 #if defined(CONFIG_SYS_I2C) || defined(CONFIG_I2C_MULTI_BUS)
100 static struct
101 {
102 	uchar	bus;
103 	uchar	addr;
104 } i2c_no_probes[] = CONFIG_SYS_I2C_NOPROBES;
105 #define GET_BUS_NUM	i2c_get_bus_num()
106 #define COMPARE_BUS(b,i)	(i2c_no_probes[(i)].bus == (b))
107 #define COMPARE_ADDR(a,i)	(i2c_no_probes[(i)].addr == (a))
108 #define NO_PROBE_ADDR(i)	i2c_no_probes[(i)].addr
109 #else		/* single bus */
110 static uchar i2c_no_probes[] = CONFIG_SYS_I2C_NOPROBES;
111 #define GET_BUS_NUM	0
112 #define COMPARE_BUS(b,i)	((b) == 0)	/* Make compiler happy */
113 #define COMPARE_ADDR(a,i)	(i2c_no_probes[(i)] == (a))
114 #define NO_PROBE_ADDR(i)	i2c_no_probes[(i)]
115 #endif	/* defined(CONFIG_SYS_I2C) */
116 #endif
117 
118 #define DISP_LINE_LEN	16
119 
120 /*
121  * Default for driver model is to use the chip's existing address length.
122  * For legacy code, this is not stored, so we need to use a suitable
123  * default.
124  */
125 #ifdef CONFIG_DM_I2C
126 #define DEFAULT_ADDR_LEN	(-1)
127 #else
128 #define DEFAULT_ADDR_LEN	1
129 #endif
130 
131 #ifdef CONFIG_DM_I2C
132 static struct udevice *i2c_cur_bus;
133 
134 static int cmd_i2c_set_bus_num(unsigned int busnum)
135 {
136 	struct udevice *bus;
137 	int ret;
138 
139 	ret = uclass_get_device_by_seq(UCLASS_I2C, busnum, &bus);
140 	if (ret) {
141 		debug("%s: No bus %d\n", __func__, busnum);
142 		return ret;
143 	}
144 	i2c_cur_bus = bus;
145 
146 	return 0;
147 }
148 
149 static int i2c_get_cur_bus(struct udevice **busp)
150 {
151 #ifdef CONFIG_I2C_SET_DEFAULT_BUS_NUM
152 	if (!i2c_cur_bus) {
153 		if (cmd_i2c_set_bus_num(CONFIG_I2C_DEFAULT_BUS_NUMBER)) {
154 			printf("Default I2C bus %d not found\n",
155 			       CONFIG_I2C_DEFAULT_BUS_NUMBER);
156 			return -ENODEV;
157 		}
158 	}
159 #endif
160 
161 	if (!i2c_cur_bus) {
162 		puts("No I2C bus selected\n");
163 		return -ENODEV;
164 	}
165 	*busp = i2c_cur_bus;
166 
167 	return 0;
168 }
169 
170 static int i2c_get_cur_bus_chip(uint chip_addr, struct udevice **devp)
171 {
172 	struct udevice *bus;
173 	int ret;
174 
175 	ret = i2c_get_cur_bus(&bus);
176 	if (ret)
177 		return ret;
178 
179 	return i2c_get_chip(bus, chip_addr, 1, devp);
180 }
181 
182 #endif
183 
184 /**
185  * i2c_init_board() - Board-specific I2C bus init
186  *
187  * This function is the default no-op implementation of I2C bus
188  * initialization. This function can be overridden by board-specific
189  * implementation if needed.
190  */
191 __weak
192 void i2c_init_board(void)
193 {
194 }
195 
196 /* TODO: Implement architecture-specific get/set functions */
197 
198 /**
199  * i2c_get_bus_speed() - Return I2C bus speed
200  *
201  * This function is the default implementation of function for retrieveing
202  * the current I2C bus speed in Hz.
203  *
204  * A driver implementing runtime switching of I2C bus speed must override
205  * this function to report the speed correctly. Simple or legacy drivers
206  * can use this fallback.
207  *
208  * Returns I2C bus speed in Hz.
209  */
210 #if !defined(CONFIG_SYS_I2C) && !defined(CONFIG_DM_I2C)
211 /*
212  * TODO: Implement architecture-specific get/set functions
213  * Should go away, if we switched completely to new multibus support
214  */
215 __weak
216 unsigned int i2c_get_bus_speed(void)
217 {
218 	return CONFIG_SYS_I2C_SPEED;
219 }
220 
221 /**
222  * i2c_set_bus_speed() - Configure I2C bus speed
223  * @speed:	Newly set speed of the I2C bus in Hz
224  *
225  * This function is the default implementation of function for setting
226  * the I2C bus speed in Hz.
227  *
228  * A driver implementing runtime switching of I2C bus speed must override
229  * this function to report the speed correctly. Simple or legacy drivers
230  * can use this fallback.
231  *
232  * Returns zero on success, negative value on error.
233  */
234 __weak
235 int i2c_set_bus_speed(unsigned int speed)
236 {
237 	if (speed != CONFIG_SYS_I2C_SPEED)
238 		return -1;
239 
240 	return 0;
241 }
242 #endif
243 
244 /**
245  * get_alen() - Small parser helper function to get address length
246  *
247  * Returns the address length.
248  */
249 static uint get_alen(char *arg, int default_len)
250 {
251 	int	j;
252 	int	alen;
253 
254 	alen = default_len;
255 	for (j = 0; j < 8; j++) {
256 		if (arg[j] == '.') {
257 			alen = arg[j+1] - '0';
258 			break;
259 		} else if (arg[j] == '\0')
260 			break;
261 	}
262 	return alen;
263 }
264 
265 enum i2c_err_op {
266 	I2C_ERR_READ,
267 	I2C_ERR_WRITE,
268 };
269 
270 static int i2c_report_err(int ret, enum i2c_err_op op)
271 {
272 	printf("Error %s the chip: %d\n",
273 	       op == I2C_ERR_READ ? "reading" : "writing", ret);
274 
275 	return CMD_RET_FAILURE;
276 }
277 
278 /**
279  * do_i2c_read() - Handle the "i2c read" command-line command
280  * @cmdtp:	Command data struct pointer
281  * @flag:	Command flag
282  * @argc:	Command-line argument count
283  * @argv:	Array of command-line arguments
284  *
285  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
286  * on error.
287  *
288  * Syntax:
289  *	i2c read {i2c_chip} {devaddr}{.0, .1, .2} {len} {memaddr}
290  */
291 static int do_i2c_read ( cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
292 {
293 	uint	chip;
294 	uint	devaddr, length;
295 	int alen;
296 	u_char  *memaddr;
297 	int ret;
298 #ifdef CONFIG_DM_I2C
299 	struct udevice *dev;
300 #endif
301 
302 	if (argc != 5)
303 		return CMD_RET_USAGE;
304 
305 	/*
306 	 * I2C chip address
307 	 */
308 	chip = simple_strtoul(argv[1], NULL, 16);
309 
310 	/*
311 	 * I2C data address within the chip.  This can be 1 or
312 	 * 2 bytes long.  Some day it might be 3 bytes long :-).
313 	 */
314 	devaddr = simple_strtoul(argv[2], NULL, 16);
315 	alen = get_alen(argv[2], DEFAULT_ADDR_LEN);
316 	if (alen > 3)
317 		return CMD_RET_USAGE;
318 
319 	/*
320 	 * Length is the number of objects, not number of bytes.
321 	 */
322 	length = simple_strtoul(argv[3], NULL, 16);
323 
324 	/*
325 	 * memaddr is the address where to store things in memory
326 	 */
327 	memaddr = (u_char *)simple_strtoul(argv[4], NULL, 16);
328 
329 #ifdef CONFIG_DM_I2C
330 	ret = i2c_get_cur_bus_chip(chip, &dev);
331 	if (!ret && alen != -1)
332 		ret = i2c_set_chip_offset_len(dev, alen);
333 	if (!ret)
334 		ret = dm_i2c_read(dev, devaddr, memaddr, length);
335 #else
336 	ret = i2c_read(chip, devaddr, alen, memaddr, length);
337 #endif
338 	if (ret)
339 		return i2c_report_err(ret, I2C_ERR_READ);
340 
341 	return 0;
342 }
343 
344 static int do_i2c_write(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
345 {
346 	uint	chip;
347 	uint	devaddr, length;
348 	int alen;
349 	u_char  *memaddr;
350 	int ret;
351 #ifdef CONFIG_DM_I2C
352 	struct udevice *dev;
353 	struct dm_i2c_chip *i2c_chip;
354 #endif
355 
356 	if ((argc < 5) || (argc > 6))
357 		return cmd_usage(cmdtp);
358 
359 	/*
360 	 * memaddr is the address where to store things in memory
361 	 */
362 	memaddr = (u_char *)simple_strtoul(argv[1], NULL, 16);
363 
364 	/*
365 	 * I2C chip address
366 	 */
367 	chip = simple_strtoul(argv[2], NULL, 16);
368 
369 	/*
370 	 * I2C data address within the chip.  This can be 1 or
371 	 * 2 bytes long.  Some day it might be 3 bytes long :-).
372 	 */
373 	devaddr = simple_strtoul(argv[3], NULL, 16);
374 	alen = get_alen(argv[3], DEFAULT_ADDR_LEN);
375 	if (alen > 3)
376 		return cmd_usage(cmdtp);
377 
378 	/*
379 	 * Length is the number of bytes.
380 	 */
381 	length = simple_strtoul(argv[4], NULL, 16);
382 
383 #ifdef CONFIG_DM_I2C
384 	ret = i2c_get_cur_bus_chip(chip, &dev);
385 	if (!ret && alen != -1)
386 		ret = i2c_set_chip_offset_len(dev, alen);
387 	if (ret)
388 		return i2c_report_err(ret, I2C_ERR_WRITE);
389 	i2c_chip = dev_get_parent_platdata(dev);
390 	if (!i2c_chip)
391 		return i2c_report_err(ret, I2C_ERR_WRITE);
392 #endif
393 
394 	if (argc == 6 && !strcmp(argv[5], "-s")) {
395 		/*
396 		 * Write all bytes in a single I2C transaction. If the target
397 		 * device is an EEPROM, it is your responsibility to not cross
398 		 * a page boundary. No write delay upon completion, take this
399 		 * into account if linking commands.
400 		 */
401 #ifdef CONFIG_DM_I2C
402 		i2c_chip->flags &= ~DM_I2C_CHIP_WR_ADDRESS;
403 		ret = dm_i2c_write(dev, devaddr, memaddr, length);
404 #else
405 		ret = i2c_write(chip, devaddr, alen, memaddr, length);
406 #endif
407 		if (ret)
408 			return i2c_report_err(ret, I2C_ERR_WRITE);
409 	} else {
410 		/*
411 		 * Repeated addressing - perform <length> separate
412 		 * write transactions of one byte each
413 		 */
414 		while (length-- > 0) {
415 #ifdef CONFIG_DM_I2C
416 			i2c_chip->flags |= DM_I2C_CHIP_WR_ADDRESS;
417 			ret = dm_i2c_write(dev, devaddr++, memaddr++, 1);
418 #else
419 			ret = i2c_write(chip, devaddr++, alen, memaddr++, 1);
420 #endif
421 			if (ret)
422 				return i2c_report_err(ret, I2C_ERR_WRITE);
423 /*
424  * No write delay with FRAM devices.
425  */
426 #if !defined(CONFIG_SYS_I2C_FRAM)
427 			udelay(11000);
428 #endif
429 		}
430 	}
431 	return 0;
432 }
433 
434 #ifdef CONFIG_DM_I2C
435 static int do_i2c_flags(cmd_tbl_t *cmdtp, int flag, int argc,
436 			char *const argv[])
437 {
438 	struct udevice *dev;
439 	uint flags;
440 	int chip;
441 	int ret;
442 
443 	if (argc < 2)
444 		return CMD_RET_USAGE;
445 
446 	chip = simple_strtoul(argv[1], NULL, 16);
447 	ret = i2c_get_cur_bus_chip(chip, &dev);
448 	if (ret)
449 		return i2c_report_err(ret, I2C_ERR_READ);
450 
451 	if (argc > 2) {
452 		flags = simple_strtoul(argv[2], NULL, 16);
453 		ret = i2c_set_chip_flags(dev, flags);
454 	} else  {
455 		ret = i2c_get_chip_flags(dev, &flags);
456 		if (!ret)
457 			printf("%x\n", flags);
458 	}
459 	if (ret)
460 		return i2c_report_err(ret, I2C_ERR_READ);
461 
462 	return 0;
463 }
464 
465 static int do_i2c_olen(cmd_tbl_t *cmdtp, int flag, int argc, char *const argv[])
466 {
467 	struct udevice *dev;
468 	uint olen;
469 	int chip;
470 	int ret;
471 
472 	if (argc < 2)
473 		return CMD_RET_USAGE;
474 
475 	chip = simple_strtoul(argv[1], NULL, 16);
476 	ret = i2c_get_cur_bus_chip(chip, &dev);
477 	if (ret)
478 		return i2c_report_err(ret, I2C_ERR_READ);
479 
480 	if (argc > 2) {
481 		olen = simple_strtoul(argv[2], NULL, 16);
482 		ret = i2c_set_chip_offset_len(dev, olen);
483 	} else  {
484 		ret = i2c_get_chip_offset_len(dev);
485 		if (ret >= 0) {
486 			printf("%x\n", ret);
487 			ret = 0;
488 		}
489 	}
490 	if (ret)
491 		return i2c_report_err(ret, I2C_ERR_READ);
492 
493 	return 0;
494 }
495 #endif
496 
497 /**
498  * do_i2c_md() - Handle the "i2c md" command-line command
499  * @cmdtp:	Command data struct pointer
500  * @flag:	Command flag
501  * @argc:	Command-line argument count
502  * @argv:	Array of command-line arguments
503  *
504  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
505  * on error.
506  *
507  * Syntax:
508  *	i2c md {i2c_chip} {addr}{.0, .1, .2} {len}
509  */
510 static int do_i2c_md ( cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
511 {
512 	uint	chip;
513 	uint	addr, length;
514 	int alen;
515 	int	j, nbytes, linebytes;
516 	int ret;
517 #ifdef CONFIG_DM_I2C
518 	struct udevice *dev;
519 #endif
520 
521 	/* We use the last specified parameters, unless new ones are
522 	 * entered.
523 	 */
524 	chip   = i2c_dp_last_chip;
525 	addr   = i2c_dp_last_addr;
526 	alen   = i2c_dp_last_alen;
527 	length = i2c_dp_last_length;
528 
529 	if (argc < 3)
530 		return CMD_RET_USAGE;
531 
532 	if ((flag & CMD_FLAG_REPEAT) == 0) {
533 		/*
534 		 * New command specified.
535 		 */
536 
537 		/*
538 		 * I2C chip address
539 		 */
540 		chip = simple_strtoul(argv[1], NULL, 16);
541 
542 		/*
543 		 * I2C data address within the chip.  This can be 1 or
544 		 * 2 bytes long.  Some day it might be 3 bytes long :-).
545 		 */
546 		addr = simple_strtoul(argv[2], NULL, 16);
547 		alen = get_alen(argv[2], DEFAULT_ADDR_LEN);
548 		if (alen > 3)
549 			return CMD_RET_USAGE;
550 
551 		/*
552 		 * If another parameter, it is the length to display.
553 		 * Length is the number of objects, not number of bytes.
554 		 */
555 		if (argc > 3)
556 			length = simple_strtoul(argv[3], NULL, 16);
557 	}
558 
559 #ifdef CONFIG_DM_I2C
560 	ret = i2c_get_cur_bus_chip(chip, &dev);
561 	if (!ret && alen != -1)
562 		ret = i2c_set_chip_offset_len(dev, alen);
563 	if (ret)
564 		return i2c_report_err(ret, I2C_ERR_READ);
565 #endif
566 
567 	/*
568 	 * Print the lines.
569 	 *
570 	 * We buffer all read data, so we can make sure data is read only
571 	 * once.
572 	 */
573 	nbytes = length;
574 	do {
575 		unsigned char	linebuf[DISP_LINE_LEN];
576 		unsigned char	*cp;
577 
578 		linebytes = (nbytes > DISP_LINE_LEN) ? DISP_LINE_LEN : nbytes;
579 
580 #ifdef CONFIG_DM_I2C
581 		ret = dm_i2c_read(dev, addr, linebuf, linebytes);
582 #else
583 		ret = i2c_read(chip, addr, alen, linebuf, linebytes);
584 #endif
585 		if (ret)
586 			return i2c_report_err(ret, I2C_ERR_READ);
587 		else {
588 			printf("%04x:", addr);
589 			cp = linebuf;
590 			for (j=0; j<linebytes; j++) {
591 				printf(" %02x", *cp++);
592 				addr++;
593 			}
594 			puts ("    ");
595 			cp = linebuf;
596 			for (j=0; j<linebytes; j++) {
597 				if ((*cp < 0x20) || (*cp > 0x7e))
598 					puts (".");
599 				else
600 					printf("%c", *cp);
601 				cp++;
602 			}
603 			putc ('\n');
604 		}
605 		nbytes -= linebytes;
606 	} while (nbytes > 0);
607 
608 	i2c_dp_last_chip   = chip;
609 	i2c_dp_last_addr   = addr;
610 	i2c_dp_last_alen   = alen;
611 	i2c_dp_last_length = length;
612 
613 	return 0;
614 }
615 
616 /**
617  * do_i2c_mw() - Handle the "i2c mw" command-line command
618  * @cmdtp:	Command data struct pointer
619  * @flag:	Command flag
620  * @argc:	Command-line argument count
621  * @argv:	Array of command-line arguments
622  *
623  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
624  * on error.
625  *
626  * Syntax:
627  *	i2c mw {i2c_chip} {addr}{.0, .1, .2} {data} [{count}]
628  */
629 static int do_i2c_mw ( cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
630 {
631 	uint	chip;
632 	ulong	addr;
633 	int	alen;
634 	uchar	byte;
635 	int	count;
636 	int ret;
637 #ifdef CONFIG_DM_I2C
638 	struct udevice *dev;
639 #endif
640 
641 	if ((argc < 4) || (argc > 5))
642 		return CMD_RET_USAGE;
643 
644 	/*
645 	 * Chip is always specified.
646 	 */
647 	chip = simple_strtoul(argv[1], NULL, 16);
648 
649 	/*
650 	 * Address is always specified.
651 	 */
652 	addr = simple_strtoul(argv[2], NULL, 16);
653 	alen = get_alen(argv[2], DEFAULT_ADDR_LEN);
654 	if (alen > 3)
655 		return CMD_RET_USAGE;
656 
657 #ifdef CONFIG_DM_I2C
658 	ret = i2c_get_cur_bus_chip(chip, &dev);
659 	if (!ret && alen != -1)
660 		ret = i2c_set_chip_offset_len(dev, alen);
661 	if (ret)
662 		return i2c_report_err(ret, I2C_ERR_WRITE);
663 #endif
664 	/*
665 	 * Value to write is always specified.
666 	 */
667 	byte = simple_strtoul(argv[3], NULL, 16);
668 
669 	/*
670 	 * Optional count
671 	 */
672 	if (argc == 5)
673 		count = simple_strtoul(argv[4], NULL, 16);
674 	else
675 		count = 1;
676 
677 	while (count-- > 0) {
678 #ifdef CONFIG_DM_I2C
679 		ret = dm_i2c_write(dev, addr++, &byte, 1);
680 #else
681 		ret = i2c_write(chip, addr++, alen, &byte, 1);
682 #endif
683 		if (ret)
684 			return i2c_report_err(ret, I2C_ERR_WRITE);
685 		/*
686 		 * Wait for the write to complete.  The write can take
687 		 * up to 10mSec (we allow a little more time).
688 		 */
689 /*
690  * No write delay with FRAM devices.
691  */
692 #if !defined(CONFIG_SYS_I2C_FRAM)
693 		udelay(11000);
694 #endif
695 	}
696 
697 	return 0;
698 }
699 
700 /**
701  * do_i2c_crc() - Handle the "i2c crc32" command-line command
702  * @cmdtp:	Command data struct pointer
703  * @flag:	Command flag
704  * @argc:	Command-line argument count
705  * @argv:	Array of command-line arguments
706  *
707  * Calculate a CRC on memory
708  *
709  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
710  * on error.
711  *
712  * Syntax:
713  *	i2c crc32 {i2c_chip} {addr}{.0, .1, .2} {count}
714  */
715 static int do_i2c_crc (cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
716 {
717 	uint	chip;
718 	ulong	addr;
719 	int	alen;
720 	int	count;
721 	uchar	byte;
722 	ulong	crc;
723 	ulong	err;
724 	int ret = 0;
725 #ifdef CONFIG_DM_I2C
726 	struct udevice *dev;
727 #endif
728 
729 	if (argc < 4)
730 		return CMD_RET_USAGE;
731 
732 	/*
733 	 * Chip is always specified.
734 	 */
735 	chip = simple_strtoul(argv[1], NULL, 16);
736 
737 	/*
738 	 * Address is always specified.
739 	 */
740 	addr = simple_strtoul(argv[2], NULL, 16);
741 	alen = get_alen(argv[2], DEFAULT_ADDR_LEN);
742 	if (alen > 3)
743 		return CMD_RET_USAGE;
744 
745 #ifdef CONFIG_DM_I2C
746 	ret = i2c_get_cur_bus_chip(chip, &dev);
747 	if (!ret && alen != -1)
748 		ret = i2c_set_chip_offset_len(dev, alen);
749 	if (ret)
750 		return i2c_report_err(ret, I2C_ERR_READ);
751 #endif
752 	/*
753 	 * Count is always specified
754 	 */
755 	count = simple_strtoul(argv[3], NULL, 16);
756 
757 	printf ("CRC32 for %08lx ... %08lx ==> ", addr, addr + count - 1);
758 	/*
759 	 * CRC a byte at a time.  This is going to be slooow, but hey, the
760 	 * memories are small and slow too so hopefully nobody notices.
761 	 */
762 	crc = 0;
763 	err = 0;
764 	while (count-- > 0) {
765 #ifdef CONFIG_DM_I2C
766 		ret = dm_i2c_read(dev, addr, &byte, 1);
767 #else
768 		ret = i2c_read(chip, addr, alen, &byte, 1);
769 #endif
770 		if (ret)
771 			err++;
772 		crc = crc32 (crc, &byte, 1);
773 		addr++;
774 	}
775 	if (err > 0)
776 		i2c_report_err(ret, I2C_ERR_READ);
777 	else
778 		printf ("%08lx\n", crc);
779 
780 	return 0;
781 }
782 
783 /**
784  * mod_i2c_mem() - Handle the "i2c mm" and "i2c nm" command-line command
785  * @cmdtp:	Command data struct pointer
786  * @flag:	Command flag
787  * @argc:	Command-line argument count
788  * @argv:	Array of command-line arguments
789  *
790  * Modify memory.
791  *
792  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
793  * on error.
794  *
795  * Syntax:
796  *	i2c mm{.b, .w, .l} {i2c_chip} {addr}{.0, .1, .2}
797  *	i2c nm{.b, .w, .l} {i2c_chip} {addr}{.0, .1, .2}
798  */
799 static int
800 mod_i2c_mem(cmd_tbl_t *cmdtp, int incrflag, int flag, int argc, char * const argv[])
801 {
802 	uint	chip;
803 	ulong	addr;
804 	int	alen;
805 	ulong	data;
806 	int	size = 1;
807 	int	nbytes;
808 	int ret;
809 #ifdef CONFIG_DM_I2C
810 	struct udevice *dev;
811 #endif
812 
813 	if (argc != 3)
814 		return CMD_RET_USAGE;
815 
816 	bootretry_reset_cmd_timeout();	/* got a good command to get here */
817 	/*
818 	 * We use the last specified parameters, unless new ones are
819 	 * entered.
820 	 */
821 	chip = i2c_mm_last_chip;
822 	addr = i2c_mm_last_addr;
823 	alen = i2c_mm_last_alen;
824 
825 	if ((flag & CMD_FLAG_REPEAT) == 0) {
826 		/*
827 		 * New command specified.  Check for a size specification.
828 		 * Defaults to byte if no or incorrect specification.
829 		 */
830 		size = cmd_get_data_size(argv[0], 1);
831 
832 		/*
833 		 * Chip is always specified.
834 		 */
835 		chip = simple_strtoul(argv[1], NULL, 16);
836 
837 		/*
838 		 * Address is always specified.
839 		 */
840 		addr = simple_strtoul(argv[2], NULL, 16);
841 		alen = get_alen(argv[2], DEFAULT_ADDR_LEN);
842 		if (alen > 3)
843 			return CMD_RET_USAGE;
844 	}
845 
846 #ifdef CONFIG_DM_I2C
847 	ret = i2c_get_cur_bus_chip(chip, &dev);
848 	if (!ret && alen != -1)
849 		ret = i2c_set_chip_offset_len(dev, alen);
850 	if (ret)
851 		return i2c_report_err(ret, I2C_ERR_WRITE);
852 #endif
853 
854 	/*
855 	 * Print the address, followed by value.  Then accept input for
856 	 * the next value.  A non-converted value exits.
857 	 */
858 	do {
859 		printf("%08lx:", addr);
860 #ifdef CONFIG_DM_I2C
861 		ret = dm_i2c_read(dev, addr, (uchar *)&data, size);
862 #else
863 		ret = i2c_read(chip, addr, alen, (uchar *)&data, size);
864 #endif
865 		if (ret)
866 			return i2c_report_err(ret, I2C_ERR_READ);
867 
868 		data = cpu_to_be32(data);
869 		if (size == 1)
870 			printf(" %02lx", (data >> 24) & 0x000000FF);
871 		else if (size == 2)
872 			printf(" %04lx", (data >> 16) & 0x0000FFFF);
873 		else
874 			printf(" %08lx", data);
875 
876 		nbytes = cli_readline(" ? ");
877 		if (nbytes == 0) {
878 			/*
879 			 * <CR> pressed as only input, don't modify current
880 			 * location and move to next.
881 			 */
882 			if (incrflag)
883 				addr += size;
884 			nbytes = size;
885 			/* good enough to not time out */
886 			bootretry_reset_cmd_timeout();
887 		}
888 #ifdef CONFIG_BOOT_RETRY_TIME
889 		else if (nbytes == -2)
890 			break;	/* timed out, exit the command	*/
891 #endif
892 		else {
893 			char *endp;
894 
895 			data = simple_strtoul(console_buffer, &endp, 16);
896 			if (size == 1)
897 				data = data << 24;
898 			else if (size == 2)
899 				data = data << 16;
900 			data = be32_to_cpu(data);
901 			nbytes = endp - console_buffer;
902 			if (nbytes) {
903 				/*
904 				 * good enough to not time out
905 				 */
906 				bootretry_reset_cmd_timeout();
907 #ifdef CONFIG_DM_I2C
908 				ret = dm_i2c_write(dev, addr, (uchar *)&data,
909 						   size);
910 #else
911 				ret = i2c_write(chip, addr, alen,
912 						(uchar *)&data, size);
913 #endif
914 				if (ret)
915 					return i2c_report_err(ret,
916 							      I2C_ERR_WRITE);
917 #ifdef CONFIG_SYS_EEPROM_PAGE_WRITE_DELAY_MS
918 				udelay(CONFIG_SYS_EEPROM_PAGE_WRITE_DELAY_MS * 1000);
919 #endif
920 				if (incrflag)
921 					addr += size;
922 			}
923 		}
924 	} while (nbytes);
925 
926 	i2c_mm_last_chip = chip;
927 	i2c_mm_last_addr = addr;
928 	i2c_mm_last_alen = alen;
929 
930 	return 0;
931 }
932 
933 /**
934  * do_i2c_probe() - Handle the "i2c probe" command-line command
935  * @cmdtp:	Command data struct pointer
936  * @flag:	Command flag
937  * @argc:	Command-line argument count
938  * @argv:	Array of command-line arguments
939  *
940  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
941  * on error.
942  *
943  * Syntax:
944  *	i2c probe {addr}
945  *
946  * Returns zero (success) if one or more I2C devices was found
947  */
948 static int do_i2c_probe (cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
949 {
950 	int j;
951 	int addr = -1;
952 	int found = 0;
953 #if defined(CONFIG_SYS_I2C_NOPROBES)
954 	int k, skip;
955 	unsigned int bus = GET_BUS_NUM;
956 #endif	/* NOPROBES */
957 	int ret;
958 #ifdef CONFIG_DM_I2C
959 	struct udevice *bus, *dev;
960 
961 	if (i2c_get_cur_bus(&bus))
962 		return CMD_RET_FAILURE;
963 #endif
964 
965 	if (argc == 2)
966 		addr = simple_strtol(argv[1], 0, 16);
967 
968 	puts ("Valid chip addresses:");
969 	for (j = 0; j < 128; j++) {
970 		if ((0 <= addr) && (j != addr))
971 			continue;
972 
973 #if defined(CONFIG_SYS_I2C_NOPROBES)
974 		skip = 0;
975 		for (k = 0; k < ARRAY_SIZE(i2c_no_probes); k++) {
976 			if (COMPARE_BUS(bus, k) && COMPARE_ADDR(j, k)) {
977 				skip = 1;
978 				break;
979 			}
980 		}
981 		if (skip)
982 			continue;
983 #endif
984 #ifdef CONFIG_DM_I2C
985 		ret = dm_i2c_probe(bus, j, 0, &dev);
986 #else
987 		ret = i2c_probe(j);
988 #endif
989 		if (ret == 0) {
990 			printf(" %02X", j);
991 			found++;
992 		}
993 	}
994 	putc ('\n');
995 
996 #if defined(CONFIG_SYS_I2C_NOPROBES)
997 	puts ("Excluded chip addresses:");
998 	for (k = 0; k < ARRAY_SIZE(i2c_no_probes); k++) {
999 		if (COMPARE_BUS(bus,k))
1000 			printf(" %02X", NO_PROBE_ADDR(k));
1001 	}
1002 	putc ('\n');
1003 #endif
1004 
1005 	return (0 == found);
1006 }
1007 
1008 /**
1009  * do_i2c_loop() - Handle the "i2c loop" command-line command
1010  * @cmdtp:	Command data struct pointer
1011  * @flag:	Command flag
1012  * @argc:	Command-line argument count
1013  * @argv:	Array of command-line arguments
1014  *
1015  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1016  * on error.
1017  *
1018  * Syntax:
1019  *	i2c loop {i2c_chip} {addr}{.0, .1, .2} [{length}] [{delay}]
1020  *	{length} - Number of bytes to read
1021  *	{delay}  - A DECIMAL number and defaults to 1000 uSec
1022  */
1023 static int do_i2c_loop(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
1024 {
1025 	uint	chip;
1026 	int alen;
1027 	uint	addr;
1028 	uint	length;
1029 	u_char	bytes[16];
1030 	int	delay;
1031 	int ret;
1032 #ifdef CONFIG_DM_I2C
1033 	struct udevice *dev;
1034 #endif
1035 
1036 	if (argc < 3)
1037 		return CMD_RET_USAGE;
1038 
1039 	/*
1040 	 * Chip is always specified.
1041 	 */
1042 	chip = simple_strtoul(argv[1], NULL, 16);
1043 
1044 	/*
1045 	 * Address is always specified.
1046 	 */
1047 	addr = simple_strtoul(argv[2], NULL, 16);
1048 	alen = get_alen(argv[2], DEFAULT_ADDR_LEN);
1049 	if (alen > 3)
1050 		return CMD_RET_USAGE;
1051 #ifdef CONFIG_DM_I2C
1052 	ret = i2c_get_cur_bus_chip(chip, &dev);
1053 	if (!ret && alen != -1)
1054 		ret = i2c_set_chip_offset_len(dev, alen);
1055 	if (ret)
1056 		return i2c_report_err(ret, I2C_ERR_WRITE);
1057 #endif
1058 
1059 	/*
1060 	 * Length is the number of objects, not number of bytes.
1061 	 */
1062 	length = 1;
1063 	length = simple_strtoul(argv[3], NULL, 16);
1064 	if (length > sizeof(bytes))
1065 		length = sizeof(bytes);
1066 
1067 	/*
1068 	 * The delay time (uSec) is optional.
1069 	 */
1070 	delay = 1000;
1071 	if (argc > 3)
1072 		delay = simple_strtoul(argv[4], NULL, 10);
1073 	/*
1074 	 * Run the loop...
1075 	 */
1076 	while (1) {
1077 #ifdef CONFIG_DM_I2C
1078 		ret = dm_i2c_read(dev, addr, bytes, length);
1079 #else
1080 		ret = i2c_read(chip, addr, alen, bytes, length);
1081 #endif
1082 		if (ret)
1083 			i2c_report_err(ret, I2C_ERR_READ);
1084 		udelay(delay);
1085 	}
1086 
1087 	/* NOTREACHED */
1088 	return 0;
1089 }
1090 
1091 /*
1092  * The SDRAM command is separately configured because many
1093  * (most?) embedded boards don't use SDRAM DIMMs.
1094  *
1095  * FIXME: Document and probably move elsewhere!
1096  */
1097 #if defined(CONFIG_CMD_SDRAM)
1098 static void print_ddr2_tcyc (u_char const b)
1099 {
1100 	printf ("%d.", (b >> 4) & 0x0F);
1101 	switch (b & 0x0F) {
1102 	case 0x0:
1103 	case 0x1:
1104 	case 0x2:
1105 	case 0x3:
1106 	case 0x4:
1107 	case 0x5:
1108 	case 0x6:
1109 	case 0x7:
1110 	case 0x8:
1111 	case 0x9:
1112 		printf ("%d ns\n", b & 0x0F);
1113 		break;
1114 	case 0xA:
1115 		puts ("25 ns\n");
1116 		break;
1117 	case 0xB:
1118 		puts ("33 ns\n");
1119 		break;
1120 	case 0xC:
1121 		puts ("66 ns\n");
1122 		break;
1123 	case 0xD:
1124 		puts ("75 ns\n");
1125 		break;
1126 	default:
1127 		puts ("?? ns\n");
1128 		break;
1129 	}
1130 }
1131 
1132 static void decode_bits (u_char const b, char const *str[], int const do_once)
1133 {
1134 	u_char mask;
1135 
1136 	for (mask = 0x80; mask != 0x00; mask >>= 1, ++str) {
1137 		if (b & mask) {
1138 			puts (*str);
1139 			if (do_once)
1140 				return;
1141 		}
1142 	}
1143 }
1144 
1145 /*
1146  * Syntax:
1147  *	i2c sdram {i2c_chip}
1148  */
1149 static int do_sdram (cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1150 {
1151 	enum { unknown, EDO, SDRAM, DDR, DDR2, DDR3, DDR4 } type;
1152 
1153 	uint	chip;
1154 	u_char	data[128];
1155 	u_char	cksum;
1156 	int	j, ret;
1157 #ifdef CONFIG_DM_I2C
1158 	struct udevice *dev;
1159 #endif
1160 
1161 	static const char *decode_CAS_DDR2[] = {
1162 		" TBD", " 6", " 5", " 4", " 3", " 2", " TBD", " TBD"
1163 	};
1164 
1165 	static const char *decode_CAS_default[] = {
1166 		" TBD", " 7", " 6", " 5", " 4", " 3", " 2", " 1"
1167 	};
1168 
1169 	static const char *decode_CS_WE_default[] = {
1170 		" TBD", " 6", " 5", " 4", " 3", " 2", " 1", " 0"
1171 	};
1172 
1173 	static const char *decode_byte21_default[] = {
1174 		"  TBD (bit 7)\n",
1175 		"  Redundant row address\n",
1176 		"  Differential clock input\n",
1177 		"  Registerd DQMB inputs\n",
1178 		"  Buffered DQMB inputs\n",
1179 		"  On-card PLL\n",
1180 		"  Registered address/control lines\n",
1181 		"  Buffered address/control lines\n"
1182 	};
1183 
1184 	static const char *decode_byte22_DDR2[] = {
1185 		"  TBD (bit 7)\n",
1186 		"  TBD (bit 6)\n",
1187 		"  TBD (bit 5)\n",
1188 		"  TBD (bit 4)\n",
1189 		"  TBD (bit 3)\n",
1190 		"  Supports partial array self refresh\n",
1191 		"  Supports 50 ohm ODT\n",
1192 		"  Supports weak driver\n"
1193 	};
1194 
1195 	static const char *decode_row_density_DDR2[] = {
1196 		"512 MiB", "256 MiB", "128 MiB", "16 GiB",
1197 		"8 GiB", "4 GiB", "2 GiB", "1 GiB"
1198 	};
1199 
1200 	static const char *decode_row_density_default[] = {
1201 		"512 MiB", "256 MiB", "128 MiB", "64 MiB",
1202 		"32 MiB", "16 MiB", "8 MiB", "4 MiB"
1203 	};
1204 
1205 	if (argc < 2)
1206 		return CMD_RET_USAGE;
1207 
1208 	/*
1209 	 * Chip is always specified.
1210 	 */
1211 	chip = simple_strtoul (argv[1], NULL, 16);
1212 
1213 #ifdef CONFIG_DM_I2C
1214 	ret = i2c_get_cur_bus_chip(chip, &dev);
1215 	if (!ret)
1216 		ret = dm_i2c_read(dev, 0, data, sizeof(data));
1217 #else
1218 	ret = i2c_read(chip, 0, 1, data, sizeof(data));
1219 #endif
1220 	if (ret) {
1221 		puts ("No SDRAM Serial Presence Detect found.\n");
1222 		return 1;
1223 	}
1224 
1225 	cksum = 0;
1226 	for (j = 0; j < 63; j++) {
1227 		cksum += data[j];
1228 	}
1229 	if (cksum != data[63]) {
1230 		printf ("WARNING: Configuration data checksum failure:\n"
1231 			"  is 0x%02x, calculated 0x%02x\n", data[63], cksum);
1232 	}
1233 	printf ("SPD data revision            %d.%d\n",
1234 		(data[62] >> 4) & 0x0F, data[62] & 0x0F);
1235 	printf ("Bytes used                   0x%02X\n", data[0]);
1236 	printf ("Serial memory size           0x%02X\n", 1 << data[1]);
1237 
1238 	puts ("Memory type                  ");
1239 	switch (data[2]) {
1240 	case 2:
1241 		type = EDO;
1242 		puts ("EDO\n");
1243 		break;
1244 	case 4:
1245 		type = SDRAM;
1246 		puts ("SDRAM\n");
1247 		break;
1248 	case 7:
1249 		type = DDR;
1250 		puts("DDR\n");
1251 		break;
1252 	case 8:
1253 		type = DDR2;
1254 		puts ("DDR2\n");
1255 		break;
1256 	case 11:
1257 		type = DDR3;
1258 		puts("DDR3\n");
1259 		break;
1260 	case 12:
1261 		type = DDR4;
1262 		puts("DDR4\n");
1263 		break;
1264 	default:
1265 		type = unknown;
1266 		puts ("unknown\n");
1267 		break;
1268 	}
1269 
1270 	puts ("Row address bits             ");
1271 	if ((data[3] & 0x00F0) == 0)
1272 		printf ("%d\n", data[3] & 0x0F);
1273 	else
1274 		printf ("%d/%d\n", data[3] & 0x0F, (data[3] >> 4) & 0x0F);
1275 
1276 	puts ("Column address bits          ");
1277 	if ((data[4] & 0x00F0) == 0)
1278 		printf ("%d\n", data[4] & 0x0F);
1279 	else
1280 		printf ("%d/%d\n", data[4] & 0x0F, (data[4] >> 4) & 0x0F);
1281 
1282 	switch (type) {
1283 	case DDR2:
1284 		printf ("Number of ranks              %d\n",
1285 			(data[5] & 0x07) + 1);
1286 		break;
1287 	default:
1288 		printf ("Module rows                  %d\n", data[5]);
1289 		break;
1290 	}
1291 
1292 	switch (type) {
1293 	case DDR2:
1294 		printf ("Module data width            %d bits\n", data[6]);
1295 		break;
1296 	default:
1297 		printf ("Module data width            %d bits\n",
1298 			(data[7] << 8) | data[6]);
1299 		break;
1300 	}
1301 
1302 	puts ("Interface signal levels      ");
1303 	switch(data[8]) {
1304 		case 0:  puts ("TTL 5.0 V\n");	break;
1305 		case 1:  puts ("LVTTL\n");	break;
1306 		case 2:  puts ("HSTL 1.5 V\n");	break;
1307 		case 3:  puts ("SSTL 3.3 V\n");	break;
1308 		case 4:  puts ("SSTL 2.5 V\n");	break;
1309 		case 5:  puts ("SSTL 1.8 V\n");	break;
1310 		default: puts ("unknown\n");	break;
1311 	}
1312 
1313 	switch (type) {
1314 	case DDR2:
1315 		printf ("SDRAM cycle time             ");
1316 		print_ddr2_tcyc (data[9]);
1317 		break;
1318 	default:
1319 		printf ("SDRAM cycle time             %d.%d ns\n",
1320 			(data[9] >> 4) & 0x0F, data[9] & 0x0F);
1321 		break;
1322 	}
1323 
1324 	switch (type) {
1325 	case DDR2:
1326 		printf ("SDRAM access time            0.%d%d ns\n",
1327 			(data[10] >> 4) & 0x0F, data[10] & 0x0F);
1328 		break;
1329 	default:
1330 		printf ("SDRAM access time            %d.%d ns\n",
1331 			(data[10] >> 4) & 0x0F, data[10] & 0x0F);
1332 		break;
1333 	}
1334 
1335 	puts ("EDC configuration            ");
1336 	switch (data[11]) {
1337 		case 0:  puts ("None\n");	break;
1338 		case 1:  puts ("Parity\n");	break;
1339 		case 2:  puts ("ECC\n");	break;
1340 		default: puts ("unknown\n");	break;
1341 	}
1342 
1343 	if ((data[12] & 0x80) == 0)
1344 		puts ("No self refresh, rate        ");
1345 	else
1346 		puts ("Self refresh, rate           ");
1347 
1348 	switch(data[12] & 0x7F) {
1349 		case 0:  puts ("15.625 us\n");	break;
1350 		case 1:  puts ("3.9 us\n");	break;
1351 		case 2:  puts ("7.8 us\n");	break;
1352 		case 3:  puts ("31.3 us\n");	break;
1353 		case 4:  puts ("62.5 us\n");	break;
1354 		case 5:  puts ("125 us\n");	break;
1355 		default: puts ("unknown\n");	break;
1356 	}
1357 
1358 	switch (type) {
1359 	case DDR2:
1360 		printf ("SDRAM width (primary)        %d\n", data[13]);
1361 		break;
1362 	default:
1363 		printf ("SDRAM width (primary)        %d\n", data[13] & 0x7F);
1364 		if ((data[13] & 0x80) != 0) {
1365 			printf ("  (second bank)              %d\n",
1366 				2 * (data[13] & 0x7F));
1367 		}
1368 		break;
1369 	}
1370 
1371 	switch (type) {
1372 	case DDR2:
1373 		if (data[14] != 0)
1374 			printf ("EDC width                    %d\n", data[14]);
1375 		break;
1376 	default:
1377 		if (data[14] != 0) {
1378 			printf ("EDC width                    %d\n",
1379 				data[14] & 0x7F);
1380 
1381 			if ((data[14] & 0x80) != 0) {
1382 				printf ("  (second bank)              %d\n",
1383 					2 * (data[14] & 0x7F));
1384 			}
1385 		}
1386 		break;
1387 	}
1388 
1389 	if (DDR2 != type) {
1390 		printf ("Min clock delay, back-to-back random column addresses "
1391 			"%d\n", data[15]);
1392 	}
1393 
1394 	puts ("Burst length(s)             ");
1395 	if (data[16] & 0x80) puts (" Page");
1396 	if (data[16] & 0x08) puts (" 8");
1397 	if (data[16] & 0x04) puts (" 4");
1398 	if (data[16] & 0x02) puts (" 2");
1399 	if (data[16] & 0x01) puts (" 1");
1400 	putc ('\n');
1401 	printf ("Number of banks              %d\n", data[17]);
1402 
1403 	switch (type) {
1404 	case DDR2:
1405 		puts ("CAS latency(s)              ");
1406 		decode_bits (data[18], decode_CAS_DDR2, 0);
1407 		putc ('\n');
1408 		break;
1409 	default:
1410 		puts ("CAS latency(s)              ");
1411 		decode_bits (data[18], decode_CAS_default, 0);
1412 		putc ('\n');
1413 		break;
1414 	}
1415 
1416 	if (DDR2 != type) {
1417 		puts ("CS latency(s)               ");
1418 		decode_bits (data[19], decode_CS_WE_default, 0);
1419 		putc ('\n');
1420 	}
1421 
1422 	if (DDR2 != type) {
1423 		puts ("WE latency(s)               ");
1424 		decode_bits (data[20], decode_CS_WE_default, 0);
1425 		putc ('\n');
1426 	}
1427 
1428 	switch (type) {
1429 	case DDR2:
1430 		puts ("Module attributes:\n");
1431 		if (data[21] & 0x80)
1432 			puts ("  TBD (bit 7)\n");
1433 		if (data[21] & 0x40)
1434 			puts ("  Analysis probe installed\n");
1435 		if (data[21] & 0x20)
1436 			puts ("  TBD (bit 5)\n");
1437 		if (data[21] & 0x10)
1438 			puts ("  FET switch external enable\n");
1439 		printf ("  %d PLLs on DIMM\n", (data[21] >> 2) & 0x03);
1440 		if (data[20] & 0x11) {
1441 			printf ("  %d active registers on DIMM\n",
1442 				(data[21] & 0x03) + 1);
1443 		}
1444 		break;
1445 	default:
1446 		puts ("Module attributes:\n");
1447 		if (!data[21])
1448 			puts ("  (none)\n");
1449 		else
1450 			decode_bits (data[21], decode_byte21_default, 0);
1451 		break;
1452 	}
1453 
1454 	switch (type) {
1455 	case DDR2:
1456 		decode_bits (data[22], decode_byte22_DDR2, 0);
1457 		break;
1458 	default:
1459 		puts ("Device attributes:\n");
1460 		if (data[22] & 0x80) puts ("  TBD (bit 7)\n");
1461 		if (data[22] & 0x40) puts ("  TBD (bit 6)\n");
1462 		if (data[22] & 0x20) puts ("  Upper Vcc tolerance 5%\n");
1463 		else                 puts ("  Upper Vcc tolerance 10%\n");
1464 		if (data[22] & 0x10) puts ("  Lower Vcc tolerance 5%\n");
1465 		else                 puts ("  Lower Vcc tolerance 10%\n");
1466 		if (data[22] & 0x08) puts ("  Supports write1/read burst\n");
1467 		if (data[22] & 0x04) puts ("  Supports precharge all\n");
1468 		if (data[22] & 0x02) puts ("  Supports auto precharge\n");
1469 		if (data[22] & 0x01) puts ("  Supports early RAS# precharge\n");
1470 		break;
1471 	}
1472 
1473 	switch (type) {
1474 	case DDR2:
1475 		printf ("SDRAM cycle time (2nd highest CAS latency)        ");
1476 		print_ddr2_tcyc (data[23]);
1477 		break;
1478 	default:
1479 		printf ("SDRAM cycle time (2nd highest CAS latency)        %d."
1480 			"%d ns\n", (data[23] >> 4) & 0x0F, data[23] & 0x0F);
1481 		break;
1482 	}
1483 
1484 	switch (type) {
1485 	case DDR2:
1486 		printf ("SDRAM access from clock (2nd highest CAS latency) 0."
1487 			"%d%d ns\n", (data[24] >> 4) & 0x0F, data[24] & 0x0F);
1488 		break;
1489 	default:
1490 		printf ("SDRAM access from clock (2nd highest CAS latency) %d."
1491 			"%d ns\n", (data[24] >> 4) & 0x0F, data[24] & 0x0F);
1492 		break;
1493 	}
1494 
1495 	switch (type) {
1496 	case DDR2:
1497 		printf ("SDRAM cycle time (3rd highest CAS latency)        ");
1498 		print_ddr2_tcyc (data[25]);
1499 		break;
1500 	default:
1501 		printf ("SDRAM cycle time (3rd highest CAS latency)        %d."
1502 			"%d ns\n", (data[25] >> 4) & 0x0F, data[25] & 0x0F);
1503 		break;
1504 	}
1505 
1506 	switch (type) {
1507 	case DDR2:
1508 		printf ("SDRAM access from clock (3rd highest CAS latency) 0."
1509 			"%d%d ns\n", (data[26] >> 4) & 0x0F, data[26] & 0x0F);
1510 		break;
1511 	default:
1512 		printf ("SDRAM access from clock (3rd highest CAS latency) %d."
1513 			"%d ns\n", (data[26] >> 4) & 0x0F, data[26] & 0x0F);
1514 		break;
1515 	}
1516 
1517 	switch (type) {
1518 	case DDR2:
1519 		printf ("Minimum row precharge        %d.%02d ns\n",
1520 			(data[27] >> 2) & 0x3F, 25 * (data[27] & 0x03));
1521 		break;
1522 	default:
1523 		printf ("Minimum row precharge        %d ns\n", data[27]);
1524 		break;
1525 	}
1526 
1527 	switch (type) {
1528 	case DDR2:
1529 		printf ("Row active to row active min %d.%02d ns\n",
1530 			(data[28] >> 2) & 0x3F, 25 * (data[28] & 0x03));
1531 		break;
1532 	default:
1533 		printf ("Row active to row active min %d ns\n", data[28]);
1534 		break;
1535 	}
1536 
1537 	switch (type) {
1538 	case DDR2:
1539 		printf ("RAS to CAS delay min         %d.%02d ns\n",
1540 			(data[29] >> 2) & 0x3F, 25 * (data[29] & 0x03));
1541 		break;
1542 	default:
1543 		printf ("RAS to CAS delay min         %d ns\n", data[29]);
1544 		break;
1545 	}
1546 
1547 	printf ("Minimum RAS pulse width      %d ns\n", data[30]);
1548 
1549 	switch (type) {
1550 	case DDR2:
1551 		puts ("Density of each row          ");
1552 		decode_bits (data[31], decode_row_density_DDR2, 1);
1553 		putc ('\n');
1554 		break;
1555 	default:
1556 		puts ("Density of each row          ");
1557 		decode_bits (data[31], decode_row_density_default, 1);
1558 		putc ('\n');
1559 		break;
1560 	}
1561 
1562 	switch (type) {
1563 	case DDR2:
1564 		puts ("Command and Address setup    ");
1565 		if (data[32] >= 0xA0) {
1566 			printf ("1.%d%d ns\n",
1567 				((data[32] >> 4) & 0x0F) - 10, data[32] & 0x0F);
1568 		} else {
1569 			printf ("0.%d%d ns\n",
1570 				((data[32] >> 4) & 0x0F), data[32] & 0x0F);
1571 		}
1572 		break;
1573 	default:
1574 		printf ("Command and Address setup    %c%d.%d ns\n",
1575 			(data[32] & 0x80) ? '-' : '+',
1576 			(data[32] >> 4) & 0x07, data[32] & 0x0F);
1577 		break;
1578 	}
1579 
1580 	switch (type) {
1581 	case DDR2:
1582 		puts ("Command and Address hold     ");
1583 		if (data[33] >= 0xA0) {
1584 			printf ("1.%d%d ns\n",
1585 				((data[33] >> 4) & 0x0F) - 10, data[33] & 0x0F);
1586 		} else {
1587 			printf ("0.%d%d ns\n",
1588 				((data[33] >> 4) & 0x0F), data[33] & 0x0F);
1589 		}
1590 		break;
1591 	default:
1592 		printf ("Command and Address hold     %c%d.%d ns\n",
1593 			(data[33] & 0x80) ? '-' : '+',
1594 			(data[33] >> 4) & 0x07, data[33] & 0x0F);
1595 		break;
1596 	}
1597 
1598 	switch (type) {
1599 	case DDR2:
1600 		printf ("Data signal input setup      0.%d%d ns\n",
1601 			(data[34] >> 4) & 0x0F, data[34] & 0x0F);
1602 		break;
1603 	default:
1604 		printf ("Data signal input setup      %c%d.%d ns\n",
1605 			(data[34] & 0x80) ? '-' : '+',
1606 			(data[34] >> 4) & 0x07, data[34] & 0x0F);
1607 		break;
1608 	}
1609 
1610 	switch (type) {
1611 	case DDR2:
1612 		printf ("Data signal input hold       0.%d%d ns\n",
1613 			(data[35] >> 4) & 0x0F, data[35] & 0x0F);
1614 		break;
1615 	default:
1616 		printf ("Data signal input hold       %c%d.%d ns\n",
1617 			(data[35] & 0x80) ? '-' : '+',
1618 			(data[35] >> 4) & 0x07, data[35] & 0x0F);
1619 		break;
1620 	}
1621 
1622 	puts ("Manufacturer's JEDEC ID      ");
1623 	for (j = 64; j <= 71; j++)
1624 		printf ("%02X ", data[j]);
1625 	putc ('\n');
1626 	printf ("Manufacturing Location       %02X\n", data[72]);
1627 	puts ("Manufacturer's Part Number   ");
1628 	for (j = 73; j <= 90; j++)
1629 		printf ("%02X ", data[j]);
1630 	putc ('\n');
1631 	printf ("Revision Code                %02X %02X\n", data[91], data[92]);
1632 	printf ("Manufacturing Date           %02X %02X\n", data[93], data[94]);
1633 	puts ("Assembly Serial Number       ");
1634 	for (j = 95; j <= 98; j++)
1635 		printf ("%02X ", data[j]);
1636 	putc ('\n');
1637 
1638 	if (DDR2 != type) {
1639 		printf ("Speed rating                 PC%d\n",
1640 			data[126] == 0x66 ? 66 : data[126]);
1641 	}
1642 	return 0;
1643 }
1644 #endif
1645 
1646 /*
1647  * Syntax:
1648  *	i2c edid {i2c_chip}
1649  */
1650 #if defined(CONFIG_I2C_EDID)
1651 int do_edid(cmd_tbl_t *cmdtp, int flag, int argc, char *const argv[])
1652 {
1653 	uint chip;
1654 	struct edid1_info edid;
1655 	int ret;
1656 #ifdef CONFIG_DM_I2C
1657 	struct udevice *dev;
1658 #endif
1659 
1660 	if (argc < 2) {
1661 		cmd_usage(cmdtp);
1662 		return 1;
1663 	}
1664 
1665 	chip = simple_strtoul(argv[1], NULL, 16);
1666 #ifdef CONFIG_DM_I2C
1667 	ret = i2c_get_cur_bus_chip(chip, &dev);
1668 	if (!ret)
1669 		ret = dm_i2c_read(dev, 0, (uchar *)&edid, sizeof(edid));
1670 #else
1671 	ret = i2c_read(chip, 0, 1, (uchar *)&edid, sizeof(edid));
1672 #endif
1673 	if (ret)
1674 		return i2c_report_err(ret, I2C_ERR_READ);
1675 
1676 	if (edid_check_info(&edid)) {
1677 		puts("Content isn't valid EDID.\n");
1678 		return 1;
1679 	}
1680 
1681 	edid_print_info(&edid);
1682 	return 0;
1683 
1684 }
1685 #endif /* CONFIG_I2C_EDID */
1686 
1687 #ifdef CONFIG_DM_I2C
1688 static void show_bus(struct udevice *bus)
1689 {
1690 	struct udevice *dev;
1691 
1692 	printf("Bus %d:\t%s", bus->req_seq, bus->name);
1693 	if (device_active(bus))
1694 		printf("  (active %d)", bus->seq);
1695 	printf("\n");
1696 	for (device_find_first_child(bus, &dev);
1697 	     dev;
1698 	     device_find_next_child(&dev)) {
1699 		struct dm_i2c_chip *chip = dev_get_parent_platdata(dev);
1700 
1701 		printf("   %02x: %s, offset len %x, flags %x\n",
1702 		       chip->chip_addr, dev->name, chip->offset_len,
1703 		       chip->flags);
1704 	}
1705 }
1706 #endif
1707 
1708 /**
1709  * do_i2c_show_bus() - Handle the "i2c bus" command-line command
1710  * @cmdtp:	Command data struct pointer
1711  * @flag:	Command flag
1712  * @argc:	Command-line argument count
1713  * @argv:	Array of command-line arguments
1714  *
1715  * Returns zero always.
1716  */
1717 #if defined(CONFIG_SYS_I2C) || defined(CONFIG_DM_I2C)
1718 static int do_i2c_show_bus(cmd_tbl_t *cmdtp, int flag, int argc,
1719 				char * const argv[])
1720 {
1721 	if (argc == 1) {
1722 		/* show all busses */
1723 #ifdef CONFIG_DM_I2C
1724 		struct udevice *bus;
1725 		struct uclass *uc;
1726 		int ret;
1727 
1728 		ret = uclass_get(UCLASS_I2C, &uc);
1729 		if (ret)
1730 			return CMD_RET_FAILURE;
1731 		uclass_foreach_dev(bus, uc)
1732 			show_bus(bus);
1733 #else
1734 		int i;
1735 
1736 		for (i = 0; i < CONFIG_SYS_NUM_I2C_BUSES; i++) {
1737 			printf("Bus %d:\t%s", i, I2C_ADAP_NR(i)->name);
1738 #ifndef CONFIG_SYS_I2C_DIRECT_BUS
1739 			int j;
1740 
1741 			for (j = 0; j < CONFIG_SYS_I2C_MAX_HOPS; j++) {
1742 				if (i2c_bus[i].next_hop[j].chip == 0)
1743 					break;
1744 				printf("->%s@0x%2x:%d",
1745 				       i2c_bus[i].next_hop[j].mux.name,
1746 				       i2c_bus[i].next_hop[j].chip,
1747 				       i2c_bus[i].next_hop[j].channel);
1748 			}
1749 #endif
1750 			printf("\n");
1751 		}
1752 #endif
1753 	} else {
1754 		int i;
1755 
1756 		/* show specific bus */
1757 		i = simple_strtoul(argv[1], NULL, 10);
1758 #ifdef CONFIG_DM_I2C
1759 		struct udevice *bus;
1760 		int ret;
1761 
1762 		ret = uclass_get_device_by_seq(UCLASS_I2C, i, &bus);
1763 		if (ret) {
1764 			printf("Invalid bus %d: err=%d\n", i, ret);
1765 			return CMD_RET_FAILURE;
1766 		}
1767 		show_bus(bus);
1768 #else
1769 		if (i >= CONFIG_SYS_NUM_I2C_BUSES) {
1770 			printf("Invalid bus %d\n", i);
1771 			return -1;
1772 		}
1773 		printf("Bus %d:\t%s", i, I2C_ADAP_NR(i)->name);
1774 #ifndef CONFIG_SYS_I2C_DIRECT_BUS
1775 			int j;
1776 			for (j = 0; j < CONFIG_SYS_I2C_MAX_HOPS; j++) {
1777 				if (i2c_bus[i].next_hop[j].chip == 0)
1778 					break;
1779 				printf("->%s@0x%2x:%d",
1780 				       i2c_bus[i].next_hop[j].mux.name,
1781 				       i2c_bus[i].next_hop[j].chip,
1782 				       i2c_bus[i].next_hop[j].channel);
1783 			}
1784 #endif
1785 		printf("\n");
1786 #endif
1787 	}
1788 
1789 	return 0;
1790 }
1791 #endif
1792 
1793 /**
1794  * do_i2c_bus_num() - Handle the "i2c dev" command-line command
1795  * @cmdtp:	Command data struct pointer
1796  * @flag:	Command flag
1797  * @argc:	Command-line argument count
1798  * @argv:	Array of command-line arguments
1799  *
1800  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1801  * on error.
1802  */
1803 #if defined(CONFIG_SYS_I2C) || defined(CONFIG_I2C_MULTI_BUS) || \
1804 		defined(CONFIG_DM_I2C)
1805 static int do_i2c_bus_num(cmd_tbl_t *cmdtp, int flag, int argc,
1806 				char * const argv[])
1807 {
1808 	int		ret = 0;
1809 	int	bus_no;
1810 
1811 	if (argc == 1) {
1812 		/* querying current setting */
1813 #ifdef CONFIG_DM_I2C
1814 		struct udevice *bus;
1815 
1816 		if (!i2c_get_cur_bus(&bus))
1817 			bus_no = bus->seq;
1818 		else
1819 			bus_no = -1;
1820 #else
1821 		bus_no = i2c_get_bus_num();
1822 #endif
1823 		printf("Current bus is %d\n", bus_no);
1824 	} else {
1825 		bus_no = simple_strtoul(argv[1], NULL, 10);
1826 #if defined(CONFIG_SYS_I2C)
1827 		if (bus_no >= CONFIG_SYS_NUM_I2C_BUSES) {
1828 			printf("Invalid bus %d\n", bus_no);
1829 			return -1;
1830 		}
1831 #endif
1832 		printf("Setting bus to %d\n", bus_no);
1833 #ifdef CONFIG_DM_I2C
1834 		ret = cmd_i2c_set_bus_num(bus_no);
1835 #else
1836 		ret = i2c_set_bus_num(bus_no);
1837 #endif
1838 		if (ret)
1839 			printf("Failure changing bus number (%d)\n", ret);
1840 	}
1841 
1842 	return ret ? CMD_RET_FAILURE : 0;
1843 }
1844 #endif  /* defined(CONFIG_SYS_I2C) */
1845 
1846 /**
1847  * do_i2c_bus_speed() - Handle the "i2c speed" command-line command
1848  * @cmdtp:	Command data struct pointer
1849  * @flag:	Command flag
1850  * @argc:	Command-line argument count
1851  * @argv:	Array of command-line arguments
1852  *
1853  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1854  * on error.
1855  */
1856 static int do_i2c_bus_speed(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1857 {
1858 	int speed, ret=0;
1859 
1860 #ifdef CONFIG_DM_I2C
1861 	struct udevice *bus;
1862 
1863 	if (i2c_get_cur_bus(&bus))
1864 		return 1;
1865 #endif
1866 	if (argc == 1) {
1867 #ifdef CONFIG_DM_I2C
1868 		speed = dm_i2c_get_bus_speed(bus);
1869 #else
1870 		speed = i2c_get_bus_speed();
1871 #endif
1872 		/* querying current speed */
1873 		printf("Current bus speed=%d\n", speed);
1874 	} else {
1875 		speed = simple_strtoul(argv[1], NULL, 10);
1876 		printf("Setting bus speed to %d Hz\n", speed);
1877 #ifdef CONFIG_DM_I2C
1878 		ret = dm_i2c_set_bus_speed(bus, speed);
1879 #else
1880 		ret = i2c_set_bus_speed(speed);
1881 #endif
1882 		if (ret)
1883 			printf("Failure changing bus speed (%d)\n", ret);
1884 	}
1885 
1886 	return ret ? CMD_RET_FAILURE : 0;
1887 }
1888 
1889 /**
1890  * do_i2c_mm() - Handle the "i2c mm" command-line command
1891  * @cmdtp:	Command data struct pointer
1892  * @flag:	Command flag
1893  * @argc:	Command-line argument count
1894  * @argv:	Array of command-line arguments
1895  *
1896  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1897  * on error.
1898  */
1899 static int do_i2c_mm(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1900 {
1901 	return mod_i2c_mem (cmdtp, 1, flag, argc, argv);
1902 }
1903 
1904 /**
1905  * do_i2c_nm() - Handle the "i2c nm" command-line command
1906  * @cmdtp:	Command data struct pointer
1907  * @flag:	Command flag
1908  * @argc:	Command-line argument count
1909  * @argv:	Array of command-line arguments
1910  *
1911  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1912  * on error.
1913  */
1914 static int do_i2c_nm(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1915 {
1916 	return mod_i2c_mem (cmdtp, 0, flag, argc, argv);
1917 }
1918 
1919 /**
1920  * do_i2c_reset() - Handle the "i2c reset" command-line command
1921  * @cmdtp:	Command data struct pointer
1922  * @flag:	Command flag
1923  * @argc:	Command-line argument count
1924  * @argv:	Array of command-line arguments
1925  *
1926  * Returns zero always.
1927  */
1928 static int do_i2c_reset(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1929 {
1930 #if defined(CONFIG_DM_I2C)
1931 	struct udevice *bus;
1932 
1933 	if (i2c_get_cur_bus(&bus))
1934 		return CMD_RET_FAILURE;
1935 	if (i2c_deblock(bus)) {
1936 		printf("Error: Not supported by the driver\n");
1937 		return CMD_RET_FAILURE;
1938 	}
1939 #elif defined(CONFIG_SYS_I2C)
1940 	i2c_init(I2C_ADAP->speed, I2C_ADAP->slaveaddr);
1941 #else
1942 	i2c_init(CONFIG_SYS_I2C_SPEED, CONFIG_SYS_I2C_SLAVE);
1943 #endif
1944 	return 0;
1945 }
1946 
1947 static cmd_tbl_t cmd_i2c_sub[] = {
1948 #if defined(CONFIG_SYS_I2C) || defined(CONFIG_DM_I2C)
1949 	U_BOOT_CMD_MKENT(bus, 1, 1, do_i2c_show_bus, "", ""),
1950 #endif
1951 	U_BOOT_CMD_MKENT(crc32, 3, 1, do_i2c_crc, "", ""),
1952 #if defined(CONFIG_SYS_I2C) || \
1953 	defined(CONFIG_I2C_MULTI_BUS) || defined(CONFIG_DM_I2C)
1954 	U_BOOT_CMD_MKENT(dev, 1, 1, do_i2c_bus_num, "", ""),
1955 #endif  /* CONFIG_I2C_MULTI_BUS */
1956 #if defined(CONFIG_I2C_EDID)
1957 	U_BOOT_CMD_MKENT(edid, 1, 1, do_edid, "", ""),
1958 #endif  /* CONFIG_I2C_EDID */
1959 	U_BOOT_CMD_MKENT(loop, 3, 1, do_i2c_loop, "", ""),
1960 	U_BOOT_CMD_MKENT(md, 3, 1, do_i2c_md, "", ""),
1961 	U_BOOT_CMD_MKENT(mm, 2, 1, do_i2c_mm, "", ""),
1962 	U_BOOT_CMD_MKENT(mw, 3, 1, do_i2c_mw, "", ""),
1963 	U_BOOT_CMD_MKENT(nm, 2, 1, do_i2c_nm, "", ""),
1964 	U_BOOT_CMD_MKENT(probe, 0, 1, do_i2c_probe, "", ""),
1965 	U_BOOT_CMD_MKENT(read, 5, 1, do_i2c_read, "", ""),
1966 	U_BOOT_CMD_MKENT(write, 6, 0, do_i2c_write, "", ""),
1967 #ifdef CONFIG_DM_I2C
1968 	U_BOOT_CMD_MKENT(flags, 2, 1, do_i2c_flags, "", ""),
1969 	U_BOOT_CMD_MKENT(olen, 2, 1, do_i2c_olen, "", ""),
1970 #endif
1971 	U_BOOT_CMD_MKENT(reset, 0, 1, do_i2c_reset, "", ""),
1972 #if defined(CONFIG_CMD_SDRAM)
1973 	U_BOOT_CMD_MKENT(sdram, 1, 1, do_sdram, "", ""),
1974 #endif
1975 	U_BOOT_CMD_MKENT(speed, 1, 1, do_i2c_bus_speed, "", ""),
1976 };
1977 
1978 static __maybe_unused void i2c_reloc(void)
1979 {
1980 	static int relocated;
1981 
1982 	if (!relocated) {
1983 		fixup_cmdtable(cmd_i2c_sub, ARRAY_SIZE(cmd_i2c_sub));
1984 		relocated = 1;
1985 	};
1986 }
1987 
1988 /**
1989  * do_i2c() - Handle the "i2c" command-line command
1990  * @cmdtp:	Command data struct pointer
1991  * @flag:	Command flag
1992  * @argc:	Command-line argument count
1993  * @argv:	Array of command-line arguments
1994  *
1995  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1996  * on error.
1997  */
1998 static int do_i2c(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1999 {
2000 	cmd_tbl_t *c;
2001 
2002 #ifdef CONFIG_NEEDS_MANUAL_RELOC
2003 	i2c_reloc();
2004 #endif
2005 
2006 	if (argc < 2)
2007 		return CMD_RET_USAGE;
2008 
2009 	/* Strip off leading 'i2c' command argument */
2010 	argc--;
2011 	argv++;
2012 
2013 	c = find_cmd_tbl(argv[0], &cmd_i2c_sub[0], ARRAY_SIZE(cmd_i2c_sub));
2014 
2015 	if (c)
2016 		return c->cmd(cmdtp, flag, argc, argv);
2017 	else
2018 		return CMD_RET_USAGE;
2019 }
2020 
2021 /***************************************************/
2022 #ifdef CONFIG_SYS_LONGHELP
2023 static char i2c_help_text[] =
2024 #if defined(CONFIG_SYS_I2C) || defined(CONFIG_DM_I2C)
2025 	"bus [muxtype:muxaddr:muxchannel] - show I2C bus info\n"
2026 	"i2c " /* That's the prefix for the crc32 command below. */
2027 #endif
2028 	"crc32 chip address[.0, .1, .2] count - compute CRC32 checksum\n"
2029 #if defined(CONFIG_SYS_I2C) || \
2030 	defined(CONFIG_I2C_MULTI_BUS) || defined(CONFIG_DM_I2C)
2031 	"i2c dev [dev] - show or set current I2C bus\n"
2032 #endif  /* CONFIG_I2C_MULTI_BUS */
2033 #if defined(CONFIG_I2C_EDID)
2034 	"i2c edid chip - print EDID configuration information\n"
2035 #endif  /* CONFIG_I2C_EDID */
2036 	"i2c loop chip address[.0, .1, .2] [# of objects] - looping read of device\n"
2037 	"i2c md chip address[.0, .1, .2] [# of objects] - read from I2C device\n"
2038 	"i2c mm chip address[.0, .1, .2] - write to I2C device (auto-incrementing)\n"
2039 	"i2c mw chip address[.0, .1, .2] value [count] - write to I2C device (fill)\n"
2040 	"i2c nm chip address[.0, .1, .2] - write to I2C device (constant address)\n"
2041 	"i2c probe [address] - test for and show device(s) on the I2C bus\n"
2042 	"i2c read chip address[.0, .1, .2] length memaddress - read to memory\n"
2043 	"i2c write memaddress chip address[.0, .1, .2] length [-s] - write memory\n"
2044 	"          to I2C; the -s option selects bulk write in a single transaction\n"
2045 #ifdef CONFIG_DM_I2C
2046 	"i2c flags chip [flags] - set or get chip flags\n"
2047 	"i2c olen chip [offset_length] - set or get chip offset length\n"
2048 #endif
2049 	"i2c reset - re-init the I2C Controller\n"
2050 #if defined(CONFIG_CMD_SDRAM)
2051 	"i2c sdram chip - print SDRAM configuration information\n"
2052 #endif
2053 	"i2c speed [speed] - show or set I2C bus speed";
2054 #endif
2055 
2056 U_BOOT_CMD(
2057 	i2c, 7, 1, do_i2c,
2058 	"I2C sub-system",
2059 	i2c_help_text
2060 );
2061