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