3 * Sergey Kubushyn, himself, ksi@koi8.net
5 * Changes for unified multibus/multiadapter I2C support.
8 * Gerald Van Baren, Custom IDEAS, vanbaren@cideas.com.
10 * SPDX-License-Identifier: GPL-2.0+
14 * I2C Functions similar to the standard memory functions.
16 * There are several parameters in many of the commands that bear further
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 :-/.
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.
35 * The default {addr} parameter is one byte (.1) which works well for
36 * memories and registers with 8 bits of address space.
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.
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).
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.
65 * Adapted from cmd_mem.c which is copyright Wolfgang Denk (wd@denx.de).
69 #include <bootretry.h>
75 #include <environment.h>
79 #include <asm/byteorder.h>
80 #include <linux/compiler.h>
82 DECLARE_GLOBAL_DATA_PTR;
84 /* Display values from last command.
85 * Memory modify remembered values are different from display memory.
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;
92 static uint i2c_mm_last_chip;
93 static uint i2c_mm_last_addr;
94 static uint i2c_mm_last_alen;
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 */
101 #if defined(CONFIG_SYS_I2C_NOPROBES)
102 #if defined(CONFIG_SYS_I2C) || defined(CONFIG_I2C_MULTI_BUS)
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) */
121 #define DISP_LINE_LEN 16
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
129 #define DEFAULT_ADDR_LEN (-1)
131 #define DEFAULT_ADDR_LEN 1
135 static struct udevice *i2c_cur_bus;
137 static int cmd_i2c_set_bus_num(unsigned int busnum)
142 ret = uclass_get_device_by_seq(UCLASS_I2C, busnum, &bus);
144 debug("%s: No bus %d\n", __func__, busnum);
152 static int i2c_get_cur_bus(struct udevice **busp)
155 puts("No I2C bus selected\n");
163 static int i2c_get_cur_bus_chip(uint chip_addr, struct udevice **devp)
168 ret = i2c_get_cur_bus(&bus);
172 return i2c_get_chip(bus, chip_addr, 1, devp);
178 * i2c_init_board() - Board-specific I2C bus init
180 * This function is the default no-op implementation of I2C bus
181 * initialization. This function can be overridden by board-specific
182 * implementation if needed.
185 void i2c_init_board(void)
189 /* TODO: Implement architecture-specific get/set functions */
192 * i2c_get_bus_speed() - Return I2C bus speed
194 * This function is the default implementation of function for retrieveing
195 * the current I2C bus speed in Hz.
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.
201 * Returns I2C bus speed in Hz.
203 #if !defined(CONFIG_SYS_I2C) && !defined(CONFIG_DM_I2C)
205 * TODO: Implement architecture-specific get/set functions
206 * Should go away, if we switched completely to new multibus support
209 unsigned int i2c_get_bus_speed(void)
211 return CONFIG_SYS_I2C_SPEED;
215 * i2c_set_bus_speed() - Configure I2C bus speed
216 * @speed: Newly set speed of the I2C bus in Hz
218 * This function is the default implementation of function for setting
219 * the I2C bus speed in Hz.
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.
225 * Returns zero on success, negative value on error.
228 int i2c_set_bus_speed(unsigned int speed)
230 if (speed != CONFIG_SYS_I2C_SPEED)
238 * get_alen() - Small parser helper function to get address length
240 * Returns the address length.
242 static uint get_alen(char *arg, int default_len)
248 for (j = 0; j < 8; j++) {
250 alen = arg[j+1] - '0';
252 } else if (arg[j] == '\0')
263 static int i2c_report_err(int ret, enum i2c_err_op op)
265 printf("Error %s the chip: %d\n",
266 op == I2C_ERR_READ ? "reading" : "writing", ret);
268 return CMD_RET_FAILURE;
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
278 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
282 * i2c read {i2c_chip} {devaddr}{.0, .1, .2} {len} {memaddr}
284 static int do_i2c_read ( cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
287 uint devaddr, length;
296 return CMD_RET_USAGE;
301 chip = simple_strtoul(argv[1], NULL, 16);
304 * I2C data address within the chip. This can be 1 or
305 * 2 bytes long. Some day it might be 3 bytes long :-).
307 devaddr = simple_strtoul(argv[2], NULL, 16);
308 alen = get_alen(argv[2], DEFAULT_ADDR_LEN);
310 return CMD_RET_USAGE;
313 * Length is the number of objects, not number of bytes.
315 length = simple_strtoul(argv[3], NULL, 16);
318 * memaddr is the address where to store things in memory
320 memaddr = (u_char *)simple_strtoul(argv[4], NULL, 16);
323 ret = i2c_get_cur_bus_chip(chip, &dev);
324 if (!ret && alen != -1)
325 ret = i2c_set_chip_offset_len(dev, alen);
327 ret = dm_i2c_read(dev, devaddr, memaddr, length);
329 ret = i2c_read(chip, devaddr, alen, memaddr, length);
332 return i2c_report_err(ret, I2C_ERR_READ);
337 static int do_i2c_write(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
340 uint devaddr, length;
346 struct dm_i2c_chip *i2c_chip;
349 if ((argc < 5) || (argc > 6))
350 return cmd_usage(cmdtp);
353 * memaddr is the address where to store things in memory
355 memaddr = (u_char *)simple_strtoul(argv[1], NULL, 16);
360 chip = simple_strtoul(argv[2], NULL, 16);
363 * I2C data address within the chip. This can be 1 or
364 * 2 bytes long. Some day it might be 3 bytes long :-).
366 devaddr = simple_strtoul(argv[3], NULL, 16);
367 alen = get_alen(argv[3], DEFAULT_ADDR_LEN);
369 return cmd_usage(cmdtp);
372 * Length is the number of bytes.
374 length = simple_strtoul(argv[4], NULL, 16);
377 ret = i2c_get_cur_bus_chip(chip, &dev);
378 if (!ret && alen != -1)
379 ret = i2c_set_chip_offset_len(dev, alen);
381 return i2c_report_err(ret, I2C_ERR_WRITE);
382 i2c_chip = dev_get_parent_platdata(dev);
384 return i2c_report_err(ret, I2C_ERR_WRITE);
387 if (argc == 6 && !strcmp(argv[5], "-s")) {
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.
395 i2c_chip->flags &= ~DM_I2C_CHIP_WR_ADDRESS;
396 ret = dm_i2c_write(dev, devaddr, memaddr, length);
398 ret = i2c_write(chip, devaddr, alen, memaddr, length);
401 return i2c_report_err(ret, I2C_ERR_WRITE);
404 * Repeated addressing - perform <length> separate
405 * write transactions of one byte each
407 while (length-- > 0) {
409 i2c_chip->flags |= DM_I2C_CHIP_WR_ADDRESS;
410 ret = dm_i2c_write(dev, devaddr++, memaddr++, 1);
412 ret = i2c_write(chip, devaddr++, alen, memaddr++, 1);
415 return i2c_report_err(ret, I2C_ERR_WRITE);
417 * No write delay with FRAM devices.
419 #if !defined(CONFIG_SYS_I2C_FRAM)
428 static int do_i2c_flags(cmd_tbl_t *cmdtp, int flag, int argc,
437 return CMD_RET_USAGE;
439 chip = simple_strtoul(argv[1], NULL, 16);
440 ret = i2c_get_cur_bus_chip(chip, &dev);
442 return i2c_report_err(ret, I2C_ERR_READ);
445 flags = simple_strtoul(argv[2], NULL, 16);
446 ret = i2c_set_chip_flags(dev, flags);
448 ret = i2c_get_chip_flags(dev, &flags);
450 printf("%x\n", flags);
453 return i2c_report_err(ret, I2C_ERR_READ);
458 static int do_i2c_olen(cmd_tbl_t *cmdtp, int flag, int argc, char *const argv[])
466 return CMD_RET_USAGE;
468 chip = simple_strtoul(argv[1], NULL, 16);
469 ret = i2c_get_cur_bus_chip(chip, &dev);
471 return i2c_report_err(ret, I2C_ERR_READ);
474 olen = simple_strtoul(argv[2], NULL, 16);
475 ret = i2c_set_chip_offset_len(dev, olen);
477 ret = i2c_get_chip_offset_len(dev);
484 return i2c_report_err(ret, I2C_ERR_READ);
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
497 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
501 * i2c md {i2c_chip} {addr}{.0, .1, .2} {len}
503 static int do_i2c_md ( cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
508 int j, nbytes, linebytes;
514 /* We use the last specified parameters, unless new ones are
517 chip = i2c_dp_last_chip;
518 addr = i2c_dp_last_addr;
519 alen = i2c_dp_last_alen;
520 length = i2c_dp_last_length;
523 return CMD_RET_USAGE;
525 if ((flag & CMD_FLAG_REPEAT) == 0) {
527 * New command specified.
533 chip = simple_strtoul(argv[1], NULL, 16);
536 * I2C data address within the chip. This can be 1 or
537 * 2 bytes long. Some day it might be 3 bytes long :-).
539 addr = simple_strtoul(argv[2], NULL, 16);
540 alen = get_alen(argv[2], DEFAULT_ADDR_LEN);
542 return CMD_RET_USAGE;
545 * If another parameter, it is the length to display.
546 * Length is the number of objects, not number of bytes.
549 length = simple_strtoul(argv[3], NULL, 16);
553 ret = i2c_get_cur_bus_chip(chip, &dev);
554 if (!ret && alen != -1)
555 ret = i2c_set_chip_offset_len(dev, alen);
557 return i2c_report_err(ret, I2C_ERR_READ);
563 * We buffer all read data, so we can make sure data is read only
568 unsigned char linebuf[DISP_LINE_LEN];
571 linebytes = (nbytes > DISP_LINE_LEN) ? DISP_LINE_LEN : nbytes;
574 ret = dm_i2c_read(dev, addr, linebuf, linebytes);
576 ret = i2c_read(chip, addr, alen, linebuf, linebytes);
579 return i2c_report_err(ret, I2C_ERR_READ);
581 printf("%04x:", addr);
583 for (j=0; j<linebytes; j++) {
584 printf(" %02x", *cp++);
589 for (j=0; j<linebytes; j++) {
590 if ((*cp < 0x20) || (*cp > 0x7e))
599 } while (nbytes > 0);
601 i2c_dp_last_chip = chip;
602 i2c_dp_last_addr = addr;
603 i2c_dp_last_alen = alen;
604 i2c_dp_last_length = length;
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
616 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
620 * i2c mw {i2c_chip} {addr}{.0, .1, .2} {data} [{count}]
622 static int do_i2c_mw ( cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
634 if ((argc < 4) || (argc > 5))
635 return CMD_RET_USAGE;
638 * Chip is always specified.
640 chip = simple_strtoul(argv[1], NULL, 16);
643 * Address is always specified.
645 addr = simple_strtoul(argv[2], NULL, 16);
646 alen = get_alen(argv[2], DEFAULT_ADDR_LEN);
648 return CMD_RET_USAGE;
651 ret = i2c_get_cur_bus_chip(chip, &dev);
652 if (!ret && alen != -1)
653 ret = i2c_set_chip_offset_len(dev, alen);
655 return i2c_report_err(ret, I2C_ERR_WRITE);
658 * Value to write is always specified.
660 byte = simple_strtoul(argv[3], NULL, 16);
666 count = simple_strtoul(argv[4], NULL, 16);
670 while (count-- > 0) {
672 ret = dm_i2c_write(dev, addr++, &byte, 1);
674 ret = i2c_write(chip, addr++, alen, &byte, 1);
677 return i2c_report_err(ret, I2C_ERR_WRITE);
679 * Wait for the write to complete. The write can take
680 * up to 10mSec (we allow a little more time).
683 * No write delay with FRAM devices.
685 #if !defined(CONFIG_SYS_I2C_FRAM)
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
700 * Calculate a CRC on memory
702 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
706 * i2c crc32 {i2c_chip} {addr}{.0, .1, .2} {count}
708 static int do_i2c_crc (cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
723 return CMD_RET_USAGE;
726 * Chip is always specified.
728 chip = simple_strtoul(argv[1], NULL, 16);
731 * Address is always specified.
733 addr = simple_strtoul(argv[2], NULL, 16);
734 alen = get_alen(argv[2], DEFAULT_ADDR_LEN);
736 return CMD_RET_USAGE;
739 ret = i2c_get_cur_bus_chip(chip, &dev);
740 if (!ret && alen != -1)
741 ret = i2c_set_chip_offset_len(dev, alen);
743 return i2c_report_err(ret, I2C_ERR_READ);
746 * Count is always specified
748 count = simple_strtoul(argv[3], NULL, 16);
750 printf ("CRC32 for %08lx ... %08lx ==> ", addr, addr + count - 1);
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.
757 while (count-- > 0) {
759 ret = dm_i2c_read(dev, addr, &byte, 1);
761 ret = i2c_read(chip, addr, alen, &byte, 1);
765 crc = crc32 (crc, &byte, 1);
769 i2c_report_err(ret, I2C_ERR_READ);
771 printf ("%08lx\n", crc);
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
785 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
789 * i2c mm{.b, .w, .l} {i2c_chip} {addr}{.0, .1, .2}
790 * i2c nm{.b, .w, .l} {i2c_chip} {addr}{.0, .1, .2}
793 mod_i2c_mem(cmd_tbl_t *cmdtp, int incrflag, int flag, int argc, char * const argv[])
807 return CMD_RET_USAGE;
809 bootretry_reset_cmd_timeout(); /* got a good command to get here */
811 * We use the last specified parameters, unless new ones are
814 chip = i2c_mm_last_chip;
815 addr = i2c_mm_last_addr;
816 alen = i2c_mm_last_alen;
818 if ((flag & CMD_FLAG_REPEAT) == 0) {
820 * New command specified. Check for a size specification.
821 * Defaults to byte if no or incorrect specification.
823 size = cmd_get_data_size(argv[0], 1);
826 * Chip is always specified.
828 chip = simple_strtoul(argv[1], NULL, 16);
831 * Address is always specified.
833 addr = simple_strtoul(argv[2], NULL, 16);
834 alen = get_alen(argv[2], DEFAULT_ADDR_LEN);
836 return CMD_RET_USAGE;
840 ret = i2c_get_cur_bus_chip(chip, &dev);
841 if (!ret && alen != -1)
842 ret = i2c_set_chip_offset_len(dev, alen);
844 return i2c_report_err(ret, I2C_ERR_WRITE);
848 * Print the address, followed by value. Then accept input for
849 * the next value. A non-converted value exits.
852 printf("%08lx:", addr);
854 ret = dm_i2c_read(dev, addr, (uchar *)&data, size);
856 ret = i2c_read(chip, addr, alen, (uchar *)&data, size);
859 return i2c_report_err(ret, I2C_ERR_READ);
861 data = cpu_to_be32(data);
863 printf(" %02lx", (data >> 24) & 0x000000FF);
865 printf(" %04lx", (data >> 16) & 0x0000FFFF);
867 printf(" %08lx", data);
869 nbytes = cli_readline(" ? ");
872 * <CR> pressed as only input, don't modify current
873 * location and move to next.
878 /* good enough to not time out */
879 bootretry_reset_cmd_timeout();
881 #ifdef CONFIG_BOOT_RETRY_TIME
882 else if (nbytes == -2)
883 break; /* timed out, exit the command */
888 data = simple_strtoul(console_buffer, &endp, 16);
893 data = be32_to_cpu(data);
894 nbytes = endp - console_buffer;
897 * good enough to not time out
899 bootretry_reset_cmd_timeout();
901 ret = dm_i2c_write(dev, addr, (uchar *)&data,
904 ret = i2c_write(chip, addr, alen,
905 (uchar *)&data, size);
908 return i2c_report_err(ret,
910 #ifdef CONFIG_SYS_EEPROM_PAGE_WRITE_DELAY_MS
911 udelay(CONFIG_SYS_EEPROM_PAGE_WRITE_DELAY_MS * 1000);
919 i2c_mm_last_chip = chip;
920 i2c_mm_last_addr = addr;
921 i2c_mm_last_alen = alen;
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
933 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
939 * Returns zero (success) if one or more I2C devices was found
941 static int do_i2c_probe (cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
946 #if defined(CONFIG_SYS_I2C_NOPROBES)
948 unsigned int bus = GET_BUS_NUM;
949 #endif /* NOPROBES */
952 struct udevice *bus, *dev;
954 if (i2c_get_cur_bus(&bus))
955 return CMD_RET_FAILURE;
959 addr = simple_strtol(argv[1], 0, 16);
961 puts ("Valid chip addresses:");
962 for (j = 0; j < 128; j++) {
963 if ((0 <= addr) && (j != addr))
966 #if defined(CONFIG_SYS_I2C_NOPROBES)
968 for (k = 0; k < ARRAY_SIZE(i2c_no_probes); k++) {
969 if (COMPARE_BUS(bus, k) && COMPARE_ADDR(j, k)) {
978 ret = dm_i2c_probe(bus, j, 0, &dev);
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));
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
1008 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
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
1016 static int do_i2c_loop(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
1025 #ifdef CONFIG_DM_I2C
1026 struct udevice *dev;
1030 return CMD_RET_USAGE;
1033 * Chip is always specified.
1035 chip = simple_strtoul(argv[1], NULL, 16);
1038 * Address is always specified.
1040 addr = simple_strtoul(argv[2], NULL, 16);
1041 alen = get_alen(argv[2], DEFAULT_ADDR_LEN);
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);
1049 return i2c_report_err(ret, I2C_ERR_WRITE);
1053 * Length is the number of objects, not number of bytes.
1056 length = simple_strtoul(argv[3], NULL, 16);
1057 if (length > sizeof(bytes))
1058 length = sizeof(bytes);
1061 * The delay time (uSec) is optional.
1065 delay = simple_strtoul(argv[4], NULL, 10);
1070 #ifdef CONFIG_DM_I2C
1071 ret = dm_i2c_read(dev, addr, bytes, length);
1073 ret = i2c_read(chip, addr, alen, bytes, length);
1076 i2c_report_err(ret, I2C_ERR_READ);
1085 * The SDRAM command is separately configured because many
1086 * (most?) embedded boards don't use SDRAM DIMMs.
1088 * FIXME: Document and probably move elsewhere!
1090 #if defined(CONFIG_CMD_SDRAM)
1091 static void print_ddr2_tcyc (u_char const b)
1093 printf ("%d.", (b >> 4) & 0x0F);
1105 printf ("%d ns\n", b & 0x0F);
1125 static void decode_bits (u_char const b, char const *str[], int const do_once)
1129 for (mask = 0x80; mask != 0x00; mask >>= 1, ++str) {
1140 * i2c sdram {i2c_chip}
1142 static int do_sdram (cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1144 enum { unknown, EDO, SDRAM, DDR, DDR2, DDR3, DDR4 } type;
1151 static const char *decode_CAS_DDR2[] = {
1152 " TBD", " 6", " 5", " 4", " 3", " 2", " TBD", " TBD"
1155 static const char *decode_CAS_default[] = {
1156 " TBD", " 7", " 6", " 5", " 4", " 3", " 2", " 1"
1159 static const char *decode_CS_WE_default[] = {
1160 " TBD", " 6", " 5", " 4", " 3", " 2", " 1", " 0"
1163 static const char *decode_byte21_default[] = {
1165 " Redundant row address\n",
1166 " Differential clock input\n",
1167 " Registerd DQMB inputs\n",
1168 " Buffered DQMB inputs\n",
1170 " Registered address/control lines\n",
1171 " Buffered address/control lines\n"
1174 static const char *decode_byte22_DDR2[] = {
1180 " Supports partial array self refresh\n",
1181 " Supports 50 ohm ODT\n",
1182 " Supports weak driver\n"
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"
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"
1196 return CMD_RET_USAGE;
1199 * Chip is always specified.
1201 chip = simple_strtoul (argv[1], NULL, 16);
1203 if (i2c_read (chip, 0, 1, data, sizeof (data)) != 0) {
1204 puts ("No SDRAM Serial Presence Detect found.\n");
1209 for (j = 0; j < 63; j++) {
1212 if (cksum != data[63]) {
1213 printf ("WARNING: Configuration data checksum failure:\n"
1214 " is 0x%02x, calculated 0x%02x\n", data[63], cksum);
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]);
1221 puts ("Memory type ");
1253 puts ("Row address bits ");
1254 if ((data[3] & 0x00F0) == 0)
1255 printf ("%d\n", data[3] & 0x0F);
1257 printf ("%d/%d\n", data[3] & 0x0F, (data[3] >> 4) & 0x0F);
1259 puts ("Column address bits ");
1260 if ((data[4] & 0x00F0) == 0)
1261 printf ("%d\n", data[4] & 0x0F);
1263 printf ("%d/%d\n", data[4] & 0x0F, (data[4] >> 4) & 0x0F);
1267 printf ("Number of ranks %d\n",
1268 (data[5] & 0x07) + 1);
1271 printf ("Module rows %d\n", data[5]);
1277 printf ("Module data width %d bits\n", data[6]);
1280 printf ("Module data width %d bits\n",
1281 (data[7] << 8) | data[6]);
1285 puts ("Interface signal levels ");
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;
1298 printf ("SDRAM cycle time ");
1299 print_ddr2_tcyc (data[9]);
1302 printf ("SDRAM cycle time %d.%d ns\n",
1303 (data[9] >> 4) & 0x0F, data[9] & 0x0F);
1309 printf ("SDRAM access time 0.%d%d ns\n",
1310 (data[10] >> 4) & 0x0F, data[10] & 0x0F);
1313 printf ("SDRAM access time %d.%d ns\n",
1314 (data[10] >> 4) & 0x0F, data[10] & 0x0F);
1318 puts ("EDC configuration ");
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;
1326 if ((data[12] & 0x80) == 0)
1327 puts ("No self refresh, rate ");
1329 puts ("Self refresh, rate ");
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;
1343 printf ("SDRAM width (primary) %d\n", data[13]);
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));
1357 printf ("EDC width %d\n", data[14]);
1360 if (data[14] != 0) {
1361 printf ("EDC width %d\n",
1364 if ((data[14] & 0x80) != 0) {
1365 printf (" (second bank) %d\n",
1366 2 * (data[14] & 0x7F));
1373 printf ("Min clock delay, back-to-back random column addresses "
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");
1384 printf ("Number of banks %d\n", data[17]);
1388 puts ("CAS latency(s) ");
1389 decode_bits (data[18], decode_CAS_DDR2, 0);
1393 puts ("CAS latency(s) ");
1394 decode_bits (data[18], decode_CAS_default, 0);
1400 puts ("CS latency(s) ");
1401 decode_bits (data[19], decode_CS_WE_default, 0);
1406 puts ("WE latency(s) ");
1407 decode_bits (data[20], decode_CS_WE_default, 0);
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);
1429 puts ("Module attributes:\n");
1433 decode_bits (data[21], decode_byte21_default, 0);
1439 decode_bits (data[22], decode_byte22_DDR2, 0);
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");
1458 printf ("SDRAM cycle time (2nd highest CAS latency) ");
1459 print_ddr2_tcyc (data[23]);
1462 printf ("SDRAM cycle time (2nd highest CAS latency) %d."
1463 "%d ns\n", (data[23] >> 4) & 0x0F, data[23] & 0x0F);
1469 printf ("SDRAM access from clock (2nd highest CAS latency) 0."
1470 "%d%d ns\n", (data[24] >> 4) & 0x0F, data[24] & 0x0F);
1473 printf ("SDRAM access from clock (2nd highest CAS latency) %d."
1474 "%d ns\n", (data[24] >> 4) & 0x0F, data[24] & 0x0F);
1480 printf ("SDRAM cycle time (3rd highest CAS latency) ");
1481 print_ddr2_tcyc (data[25]);
1484 printf ("SDRAM cycle time (3rd highest CAS latency) %d."
1485 "%d ns\n", (data[25] >> 4) & 0x0F, data[25] & 0x0F);
1491 printf ("SDRAM access from clock (3rd highest CAS latency) 0."
1492 "%d%d ns\n", (data[26] >> 4) & 0x0F, data[26] & 0x0F);
1495 printf ("SDRAM access from clock (3rd highest CAS latency) %d."
1496 "%d ns\n", (data[26] >> 4) & 0x0F, data[26] & 0x0F);
1502 printf ("Minimum row precharge %d.%02d ns\n",
1503 (data[27] >> 2) & 0x3F, 25 * (data[27] & 0x03));
1506 printf ("Minimum row precharge %d ns\n", data[27]);
1512 printf ("Row active to row active min %d.%02d ns\n",
1513 (data[28] >> 2) & 0x3F, 25 * (data[28] & 0x03));
1516 printf ("Row active to row active min %d ns\n", data[28]);
1522 printf ("RAS to CAS delay min %d.%02d ns\n",
1523 (data[29] >> 2) & 0x3F, 25 * (data[29] & 0x03));
1526 printf ("RAS to CAS delay min %d ns\n", data[29]);
1530 printf ("Minimum RAS pulse width %d ns\n", data[30]);
1534 puts ("Density of each row ");
1535 decode_bits (data[31], decode_row_density_DDR2, 1);
1539 puts ("Density of each row ");
1540 decode_bits (data[31], decode_row_density_default, 1);
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);
1552 printf ("0.%d%d ns\n",
1553 ((data[32] >> 4) & 0x0F), data[32] & 0x0F);
1557 printf ("Command and Address setup %c%d.%d ns\n",
1558 (data[32] & 0x80) ? '-' : '+',
1559 (data[32] >> 4) & 0x07, data[32] & 0x0F);
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);
1570 printf ("0.%d%d ns\n",
1571 ((data[33] >> 4) & 0x0F), data[33] & 0x0F);
1575 printf ("Command and Address hold %c%d.%d ns\n",
1576 (data[33] & 0x80) ? '-' : '+',
1577 (data[33] >> 4) & 0x07, data[33] & 0x0F);
1583 printf ("Data signal input setup 0.%d%d ns\n",
1584 (data[34] >> 4) & 0x0F, data[34] & 0x0F);
1587 printf ("Data signal input setup %c%d.%d ns\n",
1588 (data[34] & 0x80) ? '-' : '+',
1589 (data[34] >> 4) & 0x07, data[34] & 0x0F);
1595 printf ("Data signal input hold 0.%d%d ns\n",
1596 (data[35] >> 4) & 0x0F, data[35] & 0x0F);
1599 printf ("Data signal input hold %c%d.%d ns\n",
1600 (data[35] & 0x80) ? '-' : '+',
1601 (data[35] >> 4) & 0x07, data[35] & 0x0F);
1605 puts ("Manufacturer's JEDEC ID ");
1606 for (j = 64; j <= 71; j++)
1607 printf ("%02X ", data[j]);
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]);
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]);
1622 printf ("Speed rating PC%d\n",
1623 data[126] == 0x66 ? 66 : data[126]);
1631 * i2c edid {i2c_chip}
1633 #if defined(CONFIG_I2C_EDID)
1634 int do_edid(cmd_tbl_t *cmdtp, int flag, int argc, char *const argv[])
1637 struct edid1_info edid;
1639 #ifdef CONFIG_DM_I2C
1640 struct udevice *dev;
1648 chip = simple_strtoul(argv[1], NULL, 16);
1649 #ifdef CONFIG_DM_I2C
1650 ret = i2c_get_cur_bus_chip(chip, &dev);
1652 ret = dm_i2c_read(dev, 0, (uchar *)&edid, sizeof(edid));
1654 ret = i2c_read(chip, 0, 1, (uchar *)&edid, sizeof(edid));
1657 return i2c_report_err(ret, I2C_ERR_READ);
1659 if (edid_check_info(&edid)) {
1660 puts("Content isn't valid EDID.\n");
1664 edid_print_info(&edid);
1668 #endif /* CONFIG_I2C_EDID */
1670 #ifdef CONFIG_DM_I2C
1671 static void show_bus(struct udevice *bus)
1673 struct udevice *dev;
1675 printf("Bus %d:\t%s", bus->req_seq, bus->name);
1676 if (device_active(bus))
1677 printf(" (active %d)", bus->seq);
1679 for (device_find_first_child(bus, &dev);
1681 device_find_next_child(&dev)) {
1682 struct dm_i2c_chip *chip = dev_get_parent_platdata(dev);
1684 printf(" %02x: %s, offset len %x, flags %x\n",
1685 chip->chip_addr, dev->name, chip->offset_len,
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
1698 * Returns zero always.
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[])
1705 /* show all busses */
1706 #ifdef CONFIG_DM_I2C
1707 struct udevice *bus;
1711 ret = uclass_get(UCLASS_I2C, &uc);
1713 return CMD_RET_FAILURE;
1714 uclass_foreach_dev(bus, uc)
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
1724 for (j = 0; j < CONFIG_SYS_I2C_MAX_HOPS; j++) {
1725 if (i2c_bus[i].next_hop[j].chip == 0)
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);
1739 /* show specific bus */
1740 i = simple_strtoul(argv[1], NULL, 10);
1741 #ifdef CONFIG_DM_I2C
1742 struct udevice *bus;
1745 ret = uclass_get_device_by_seq(UCLASS_I2C, i, &bus);
1747 printf("Invalid bus %d: err=%d\n", i, ret);
1748 return CMD_RET_FAILURE;
1752 if (i >= CONFIG_SYS_NUM_I2C_BUSES) {
1753 printf("Invalid bus %d\n", i);
1756 printf("Bus %d:\t%s", i, I2C_ADAP_NR(i)->name);
1757 #ifndef CONFIG_SYS_I2C_DIRECT_BUS
1759 for (j = 0; j < CONFIG_SYS_I2C_MAX_HOPS; j++) {
1760 if (i2c_bus[i].next_hop[j].chip == 0)
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);
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
1783 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
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[])
1795 /* querying current setting */
1796 #ifdef CONFIG_DM_I2C
1797 struct udevice *bus;
1799 if (!i2c_get_cur_bus(&bus))
1804 bus_no = i2c_get_bus_num();
1806 printf("Current bus is %d\n", bus_no);
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);
1815 printf("Setting bus to %d\n", bus_no);
1816 #ifdef CONFIG_DM_I2C
1817 ret = cmd_i2c_set_bus_num(bus_no);
1819 ret = i2c_set_bus_num(bus_no);
1822 printf("Failure changing bus number (%d)\n", ret);
1825 return ret ? CMD_RET_FAILURE : 0;
1827 #endif /* defined(CONFIG_SYS_I2C) */
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
1836 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1839 static int do_i2c_bus_speed(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1843 #ifdef CONFIG_DM_I2C
1844 struct udevice *bus;
1846 if (i2c_get_cur_bus(&bus))
1850 #ifdef CONFIG_DM_I2C
1851 speed = dm_i2c_get_bus_speed(bus);
1853 speed = i2c_get_bus_speed();
1855 /* querying current speed */
1856 printf("Current bus speed=%d\n", speed);
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);
1863 ret = i2c_set_bus_speed(speed);
1866 printf("Failure changing bus speed (%d)\n", ret);
1869 return ret ? CMD_RET_FAILURE : 0;
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
1879 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1882 static int do_i2c_mm(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1884 return mod_i2c_mem (cmdtp, 1, flag, argc, argv);
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
1894 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1897 static int do_i2c_nm(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1899 return mod_i2c_mem (cmdtp, 0, flag, argc, argv);
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
1909 * Returns zero always.
1911 static int do_i2c_reset(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1913 #if defined(CONFIG_DM_I2C)
1914 struct udevice *bus;
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;
1922 #elif defined(CONFIG_SYS_I2C)
1923 i2c_init(I2C_ADAP->speed, I2C_ADAP->slaveaddr);
1925 i2c_init(CONFIG_SYS_I2C_SPEED, CONFIG_SYS_I2C_SLAVE);
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, "", ""),
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, "", ""),
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, "", ""),
1958 U_BOOT_CMD_MKENT(speed, 1, 1, do_i2c_bus_speed, "", ""),
1961 static __maybe_unused void i2c_reloc(void)
1963 static int relocated;
1966 fixup_cmdtable(cmd_i2c_sub, ARRAY_SIZE(cmd_i2c_sub));
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
1978 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1981 static int do_i2c(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1985 #ifdef CONFIG_NEEDS_MANUAL_RELOC
1990 return CMD_RET_USAGE;
1992 /* Strip off leading 'i2c' command argument */
1996 c = find_cmd_tbl(argv[0], &cmd_i2c_sub[0], ARRAY_SIZE(cmd_i2c_sub));
1999 return c->cmd(cmdtp, flag, argc, argv);
2001 return CMD_RET_USAGE;
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"
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"
2031 "i2c reset - re-init the I2C Controller\n"
2032 #if defined(CONFIG_CMD_SDRAM)
2033 "i2c sdram chip - print SDRAM configuration information\n"
2035 "i2c speed [speed] - show or set I2C bus speed";