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 /* Display values from last command.
83 * Memory modify remembered values are different from display memory.
85 static uint i2c_dp_last_chip;
86 static uint i2c_dp_last_addr;
87 static uint i2c_dp_last_alen;
88 static uint i2c_dp_last_length = 0x10;
90 static uint i2c_mm_last_chip;
91 static uint i2c_mm_last_addr;
92 static uint i2c_mm_last_alen;
94 /* If only one I2C bus is present, the list of devices to ignore when
95 * the probe command is issued is represented by a 1D array of addresses.
96 * When multiple buses are present, the list is an array of bus-address
97 * pairs. The following macros take care of this */
99 #if defined(CONFIG_SYS_I2C_NOPROBES)
100 #if defined(CONFIG_SYS_I2C) || defined(CONFIG_I2C_MULTI_BUS)
105 } i2c_no_probes[] = CONFIG_SYS_I2C_NOPROBES;
106 #define GET_BUS_NUM i2c_get_bus_num()
107 #define COMPARE_BUS(b,i) (i2c_no_probes[(i)].bus == (b))
108 #define COMPARE_ADDR(a,i) (i2c_no_probes[(i)].addr == (a))
109 #define NO_PROBE_ADDR(i) i2c_no_probes[(i)].addr
110 #else /* single bus */
111 static uchar i2c_no_probes[] = CONFIG_SYS_I2C_NOPROBES;
112 #define GET_BUS_NUM 0
113 #define COMPARE_BUS(b,i) ((b) == 0) /* Make compiler happy */
114 #define COMPARE_ADDR(a,i) (i2c_no_probes[(i)] == (a))
115 #define NO_PROBE_ADDR(i) i2c_no_probes[(i)]
116 #endif /* defined(CONFIG_SYS_I2C) */
119 #define DISP_LINE_LEN 16
122 * Default for driver model is to use the chip's existing address length.
123 * For legacy code, this is not stored, so we need to use a suitable
127 #define DEFAULT_ADDR_LEN (-1)
129 #define DEFAULT_ADDR_LEN 1
133 static struct udevice *i2c_cur_bus;
135 static int cmd_i2c_set_bus_num(unsigned int busnum)
140 ret = uclass_get_device_by_seq(UCLASS_I2C, busnum, &bus);
142 debug("%s: No bus %d\n", __func__, busnum);
150 static int i2c_get_cur_bus(struct udevice **busp)
152 #ifdef CONFIG_I2C_SET_DEFAULT_BUS_NUM
154 if (cmd_i2c_set_bus_num(CONFIG_I2C_DEFAULT_BUS_NUMBER)) {
155 printf("Default I2C bus %d not found\n",
156 CONFIG_I2C_DEFAULT_BUS_NUMBER);
163 puts("No I2C bus selected\n");
171 static int i2c_get_cur_bus_chip(uint chip_addr, struct udevice **devp)
176 ret = i2c_get_cur_bus(&bus);
180 return i2c_get_chip(bus, chip_addr, 1, devp);
186 * i2c_init_board() - Board-specific I2C bus init
188 * This function is the default no-op implementation of I2C bus
189 * initialization. This function can be overridden by board-specific
190 * implementation if needed.
193 void i2c_init_board(void)
197 /* TODO: Implement architecture-specific get/set functions */
200 * i2c_get_bus_speed() - Return I2C bus speed
202 * This function is the default implementation of function for retrieveing
203 * the current I2C bus speed in Hz.
205 * A driver implementing runtime switching of I2C bus speed must override
206 * this function to report the speed correctly. Simple or legacy drivers
207 * can use this fallback.
209 * Returns I2C bus speed in Hz.
211 #if !defined(CONFIG_SYS_I2C) && !defined(CONFIG_DM_I2C)
213 * TODO: Implement architecture-specific get/set functions
214 * Should go away, if we switched completely to new multibus support
217 unsigned int i2c_get_bus_speed(void)
219 return CONFIG_SYS_I2C_SPEED;
223 * i2c_set_bus_speed() - Configure I2C bus speed
224 * @speed: Newly set speed of the I2C bus in Hz
226 * This function is the default implementation of function for setting
227 * the I2C bus speed in Hz.
229 * A driver implementing runtime switching of I2C bus speed must override
230 * this function to report the speed correctly. Simple or legacy drivers
231 * can use this fallback.
233 * Returns zero on success, negative value on error.
236 int i2c_set_bus_speed(unsigned int speed)
238 if (speed != CONFIG_SYS_I2C_SPEED)
246 * get_alen() - Small parser helper function to get address length
248 * Returns the address length.
250 static uint get_alen(char *arg, int default_len)
256 for (j = 0; j < 8; j++) {
258 alen = arg[j+1] - '0';
260 } else if (arg[j] == '\0')
271 static int i2c_report_err(int ret, enum i2c_err_op op)
273 printf("Error %s the chip: %d\n",
274 op == I2C_ERR_READ ? "reading" : "writing", ret);
276 return CMD_RET_FAILURE;
280 * do_i2c_read() - Handle the "i2c read" command-line command
281 * @cmdtp: Command data struct pointer
282 * @flag: Command flag
283 * @argc: Command-line argument count
284 * @argv: Array of command-line arguments
286 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
290 * i2c read {i2c_chip} {devaddr}{.0, .1, .2} {len} {memaddr}
292 static int do_i2c_read ( cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
295 uint devaddr, length;
304 return CMD_RET_USAGE;
309 chip = simple_strtoul(argv[1], NULL, 16);
312 * I2C data address within the chip. This can be 1 or
313 * 2 bytes long. Some day it might be 3 bytes long :-).
315 devaddr = simple_strtoul(argv[2], NULL, 16);
316 alen = get_alen(argv[2], DEFAULT_ADDR_LEN);
318 return CMD_RET_USAGE;
321 * Length is the number of objects, not number of bytes.
323 length = simple_strtoul(argv[3], NULL, 16);
326 * memaddr is the address where to store things in memory
328 memaddr = (u_char *)simple_strtoul(argv[4], NULL, 16);
331 ret = i2c_get_cur_bus_chip(chip, &dev);
332 if (!ret && alen != -1)
333 ret = i2c_set_chip_offset_len(dev, alen);
335 ret = dm_i2c_read(dev, devaddr, memaddr, length);
337 ret = i2c_read(chip, devaddr, alen, memaddr, length);
340 return i2c_report_err(ret, I2C_ERR_READ);
345 static int do_i2c_write(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
348 uint devaddr, length;
354 struct dm_i2c_chip *i2c_chip;
357 if ((argc < 5) || (argc > 6))
358 return cmd_usage(cmdtp);
361 * memaddr is the address where to store things in memory
363 memaddr = (u_char *)simple_strtoul(argv[1], NULL, 16);
368 chip = simple_strtoul(argv[2], NULL, 16);
371 * I2C data address within the chip. This can be 1 or
372 * 2 bytes long. Some day it might be 3 bytes long :-).
374 devaddr = simple_strtoul(argv[3], NULL, 16);
375 alen = get_alen(argv[3], DEFAULT_ADDR_LEN);
377 return cmd_usage(cmdtp);
380 * Length is the number of bytes.
382 length = simple_strtoul(argv[4], NULL, 16);
385 ret = i2c_get_cur_bus_chip(chip, &dev);
386 if (!ret && alen != -1)
387 ret = i2c_set_chip_offset_len(dev, alen);
389 return i2c_report_err(ret, I2C_ERR_WRITE);
390 i2c_chip = dev_get_parent_platdata(dev);
392 return i2c_report_err(ret, I2C_ERR_WRITE);
395 if (argc == 6 && !strcmp(argv[5], "-s")) {
397 * Write all bytes in a single I2C transaction. If the target
398 * device is an EEPROM, it is your responsibility to not cross
399 * a page boundary. No write delay upon completion, take this
400 * into account if linking commands.
403 i2c_chip->flags &= ~DM_I2C_CHIP_WR_ADDRESS;
404 ret = dm_i2c_write(dev, devaddr, memaddr, length);
406 ret = i2c_write(chip, devaddr, alen, memaddr, length);
409 return i2c_report_err(ret, I2C_ERR_WRITE);
412 * Repeated addressing - perform <length> separate
413 * write transactions of one byte each
415 while (length-- > 0) {
417 i2c_chip->flags |= DM_I2C_CHIP_WR_ADDRESS;
418 ret = dm_i2c_write(dev, devaddr++, memaddr++, 1);
420 ret = i2c_write(chip, devaddr++, alen, memaddr++, 1);
423 return i2c_report_err(ret, I2C_ERR_WRITE);
425 * No write delay with FRAM devices.
427 #if !defined(CONFIG_SYS_I2C_FRAM)
436 static int do_i2c_flags(cmd_tbl_t *cmdtp, int flag, int argc,
445 return CMD_RET_USAGE;
447 chip = simple_strtoul(argv[1], NULL, 16);
448 ret = i2c_get_cur_bus_chip(chip, &dev);
450 return i2c_report_err(ret, I2C_ERR_READ);
453 flags = simple_strtoul(argv[2], NULL, 16);
454 ret = i2c_set_chip_flags(dev, flags);
456 ret = i2c_get_chip_flags(dev, &flags);
458 printf("%x\n", flags);
461 return i2c_report_err(ret, I2C_ERR_READ);
466 static int do_i2c_olen(cmd_tbl_t *cmdtp, int flag, int argc, char *const argv[])
474 return CMD_RET_USAGE;
476 chip = simple_strtoul(argv[1], NULL, 16);
477 ret = i2c_get_cur_bus_chip(chip, &dev);
479 return i2c_report_err(ret, I2C_ERR_READ);
482 olen = simple_strtoul(argv[2], NULL, 16);
483 ret = i2c_set_chip_offset_len(dev, olen);
485 ret = i2c_get_chip_offset_len(dev);
492 return i2c_report_err(ret, I2C_ERR_READ);
499 * do_i2c_md() - Handle the "i2c md" command-line command
500 * @cmdtp: Command data struct pointer
501 * @flag: Command flag
502 * @argc: Command-line argument count
503 * @argv: Array of command-line arguments
505 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
509 * i2c md {i2c_chip} {addr}{.0, .1, .2} {len}
511 static int do_i2c_md ( cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
516 int j, nbytes, linebytes;
522 /* We use the last specified parameters, unless new ones are
525 chip = i2c_dp_last_chip;
526 addr = i2c_dp_last_addr;
527 alen = i2c_dp_last_alen;
528 length = i2c_dp_last_length;
531 return CMD_RET_USAGE;
533 if ((flag & CMD_FLAG_REPEAT) == 0) {
535 * New command specified.
541 chip = simple_strtoul(argv[1], NULL, 16);
544 * I2C data address within the chip. This can be 1 or
545 * 2 bytes long. Some day it might be 3 bytes long :-).
547 addr = simple_strtoul(argv[2], NULL, 16);
548 alen = get_alen(argv[2], DEFAULT_ADDR_LEN);
550 return CMD_RET_USAGE;
553 * If another parameter, it is the length to display.
554 * Length is the number of objects, not number of bytes.
557 length = simple_strtoul(argv[3], NULL, 16);
561 ret = i2c_get_cur_bus_chip(chip, &dev);
562 if (!ret && alen != -1)
563 ret = i2c_set_chip_offset_len(dev, alen);
565 return i2c_report_err(ret, I2C_ERR_READ);
571 * We buffer all read data, so we can make sure data is read only
576 unsigned char linebuf[DISP_LINE_LEN];
579 linebytes = (nbytes > DISP_LINE_LEN) ? DISP_LINE_LEN : nbytes;
582 ret = dm_i2c_read(dev, addr, linebuf, linebytes);
584 ret = i2c_read(chip, addr, alen, linebuf, linebytes);
587 return i2c_report_err(ret, I2C_ERR_READ);
589 printf("%04x:", addr);
591 for (j=0; j<linebytes; j++) {
592 printf(" %02x", *cp++);
597 for (j=0; j<linebytes; j++) {
598 if ((*cp < 0x20) || (*cp > 0x7e))
607 } while (nbytes > 0);
609 i2c_dp_last_chip = chip;
610 i2c_dp_last_addr = addr;
611 i2c_dp_last_alen = alen;
612 i2c_dp_last_length = length;
618 * do_i2c_mw() - Handle the "i2c mw" command-line command
619 * @cmdtp: Command data struct pointer
620 * @flag: Command flag
621 * @argc: Command-line argument count
622 * @argv: Array of command-line arguments
624 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
628 * i2c mw {i2c_chip} {addr}{.0, .1, .2} {data} [{count}]
630 static int do_i2c_mw ( cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
642 if ((argc < 4) || (argc > 5))
643 return CMD_RET_USAGE;
646 * Chip is always specified.
648 chip = simple_strtoul(argv[1], NULL, 16);
651 * Address is always specified.
653 addr = simple_strtoul(argv[2], NULL, 16);
654 alen = get_alen(argv[2], DEFAULT_ADDR_LEN);
656 return CMD_RET_USAGE;
659 ret = i2c_get_cur_bus_chip(chip, &dev);
660 if (!ret && alen != -1)
661 ret = i2c_set_chip_offset_len(dev, alen);
663 return i2c_report_err(ret, I2C_ERR_WRITE);
666 * Value to write is always specified.
668 byte = simple_strtoul(argv[3], NULL, 16);
674 count = simple_strtoul(argv[4], NULL, 16);
678 while (count-- > 0) {
680 ret = dm_i2c_write(dev, addr++, &byte, 1);
682 ret = i2c_write(chip, addr++, alen, &byte, 1);
685 return i2c_report_err(ret, I2C_ERR_WRITE);
687 * Wait for the write to complete. The write can take
688 * up to 10mSec (we allow a little more time).
691 * No write delay with FRAM devices.
693 #if !defined(CONFIG_SYS_I2C_FRAM)
702 * do_i2c_crc() - Handle the "i2c crc32" command-line command
703 * @cmdtp: Command data struct pointer
704 * @flag: Command flag
705 * @argc: Command-line argument count
706 * @argv: Array of command-line arguments
708 * Calculate a CRC on memory
710 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
714 * i2c crc32 {i2c_chip} {addr}{.0, .1, .2} {count}
716 static int do_i2c_crc (cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
731 return CMD_RET_USAGE;
734 * Chip is always specified.
736 chip = simple_strtoul(argv[1], NULL, 16);
739 * Address is always specified.
741 addr = simple_strtoul(argv[2], NULL, 16);
742 alen = get_alen(argv[2], DEFAULT_ADDR_LEN);
744 return CMD_RET_USAGE;
747 ret = i2c_get_cur_bus_chip(chip, &dev);
748 if (!ret && alen != -1)
749 ret = i2c_set_chip_offset_len(dev, alen);
751 return i2c_report_err(ret, I2C_ERR_READ);
754 * Count is always specified
756 count = simple_strtoul(argv[3], NULL, 16);
758 printf ("CRC32 for %08lx ... %08lx ==> ", addr, addr + count - 1);
760 * CRC a byte at a time. This is going to be slooow, but hey, the
761 * memories are small and slow too so hopefully nobody notices.
765 while (count-- > 0) {
767 ret = dm_i2c_read(dev, addr, &byte, 1);
769 ret = i2c_read(chip, addr, alen, &byte, 1);
773 crc = crc32 (crc, &byte, 1);
777 i2c_report_err(ret, I2C_ERR_READ);
779 printf ("%08lx\n", crc);
785 * mod_i2c_mem() - Handle the "i2c mm" and "i2c nm" command-line command
786 * @cmdtp: Command data struct pointer
787 * @flag: Command flag
788 * @argc: Command-line argument count
789 * @argv: Array of command-line arguments
793 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
797 * i2c mm{.b, .w, .l} {i2c_chip} {addr}{.0, .1, .2}
798 * i2c nm{.b, .w, .l} {i2c_chip} {addr}{.0, .1, .2}
801 mod_i2c_mem(cmd_tbl_t *cmdtp, int incrflag, int flag, int argc, char * const argv[])
815 return CMD_RET_USAGE;
817 bootretry_reset_cmd_timeout(); /* got a good command to get here */
819 * We use the last specified parameters, unless new ones are
822 chip = i2c_mm_last_chip;
823 addr = i2c_mm_last_addr;
824 alen = i2c_mm_last_alen;
826 if ((flag & CMD_FLAG_REPEAT) == 0) {
828 * New command specified. Check for a size specification.
829 * Defaults to byte if no or incorrect specification.
831 size = cmd_get_data_size(argv[0], 1);
834 * Chip is always specified.
836 chip = simple_strtoul(argv[1], NULL, 16);
839 * Address is always specified.
841 addr = simple_strtoul(argv[2], NULL, 16);
842 alen = get_alen(argv[2], DEFAULT_ADDR_LEN);
844 return CMD_RET_USAGE;
848 ret = i2c_get_cur_bus_chip(chip, &dev);
849 if (!ret && alen != -1)
850 ret = i2c_set_chip_offset_len(dev, alen);
852 return i2c_report_err(ret, I2C_ERR_WRITE);
856 * Print the address, followed by value. Then accept input for
857 * the next value. A non-converted value exits.
860 printf("%08lx:", addr);
862 ret = dm_i2c_read(dev, addr, (uchar *)&data, size);
864 ret = i2c_read(chip, addr, alen, (uchar *)&data, size);
867 return i2c_report_err(ret, I2C_ERR_READ);
869 data = cpu_to_be32(data);
871 printf(" %02lx", (data >> 24) & 0x000000FF);
873 printf(" %04lx", (data >> 16) & 0x0000FFFF);
875 printf(" %08lx", data);
877 nbytes = cli_readline(" ? ");
880 * <CR> pressed as only input, don't modify current
881 * location and move to next.
886 /* good enough to not time out */
887 bootretry_reset_cmd_timeout();
889 #ifdef CONFIG_BOOT_RETRY_TIME
890 else if (nbytes == -2)
891 break; /* timed out, exit the command */
896 data = simple_strtoul(console_buffer, &endp, 16);
901 data = be32_to_cpu(data);
902 nbytes = endp - console_buffer;
905 * good enough to not time out
907 bootretry_reset_cmd_timeout();
909 ret = dm_i2c_write(dev, addr, (uchar *)&data,
912 ret = i2c_write(chip, addr, alen,
913 (uchar *)&data, size);
916 return i2c_report_err(ret,
918 #ifdef CONFIG_SYS_EEPROM_PAGE_WRITE_DELAY_MS
919 udelay(CONFIG_SYS_EEPROM_PAGE_WRITE_DELAY_MS * 1000);
927 i2c_mm_last_chip = chip;
928 i2c_mm_last_addr = addr;
929 i2c_mm_last_alen = alen;
935 * do_i2c_probe() - Handle the "i2c probe" command-line command
936 * @cmdtp: Command data struct pointer
937 * @flag: Command flag
938 * @argc: Command-line argument count
939 * @argv: Array of command-line arguments
941 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
947 * Returns zero (success) if one or more I2C devices was found
949 static int do_i2c_probe (cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
954 #if defined(CONFIG_SYS_I2C_NOPROBES)
956 unsigned int bus = GET_BUS_NUM;
957 #endif /* NOPROBES */
960 struct udevice *bus, *dev;
962 if (i2c_get_cur_bus(&bus))
963 return CMD_RET_FAILURE;
967 addr = simple_strtol(argv[1], 0, 16);
969 puts ("Valid chip addresses:");
970 for (j = 0; j < 128; j++) {
971 if ((0 <= addr) && (j != addr))
974 #if defined(CONFIG_SYS_I2C_NOPROBES)
976 for (k = 0; k < ARRAY_SIZE(i2c_no_probes); k++) {
977 if (COMPARE_BUS(bus, k) && COMPARE_ADDR(j, k)) {
986 ret = dm_i2c_probe(bus, j, 0, &dev);
997 #if defined(CONFIG_SYS_I2C_NOPROBES)
998 puts ("Excluded chip addresses:");
999 for (k = 0; k < ARRAY_SIZE(i2c_no_probes); k++) {
1000 if (COMPARE_BUS(bus,k))
1001 printf(" %02X", NO_PROBE_ADDR(k));
1006 return (0 == found);
1010 * do_i2c_loop() - Handle the "i2c loop" command-line command
1011 * @cmdtp: Command data struct pointer
1012 * @flag: Command flag
1013 * @argc: Command-line argument count
1014 * @argv: Array of command-line arguments
1016 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1020 * i2c loop {i2c_chip} {addr}{.0, .1, .2} [{length}] [{delay}]
1021 * {length} - Number of bytes to read
1022 * {delay} - A DECIMAL number and defaults to 1000 uSec
1024 static int do_i2c_loop(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
1033 #ifdef CONFIG_DM_I2C
1034 struct udevice *dev;
1038 return CMD_RET_USAGE;
1041 * Chip is always specified.
1043 chip = simple_strtoul(argv[1], NULL, 16);
1046 * Address is always specified.
1048 addr = simple_strtoul(argv[2], NULL, 16);
1049 alen = get_alen(argv[2], DEFAULT_ADDR_LEN);
1051 return CMD_RET_USAGE;
1052 #ifdef CONFIG_DM_I2C
1053 ret = i2c_get_cur_bus_chip(chip, &dev);
1054 if (!ret && alen != -1)
1055 ret = i2c_set_chip_offset_len(dev, alen);
1057 return i2c_report_err(ret, I2C_ERR_WRITE);
1061 * Length is the number of objects, not number of bytes.
1064 length = simple_strtoul(argv[3], NULL, 16);
1065 if (length > sizeof(bytes))
1066 length = sizeof(bytes);
1069 * The delay time (uSec) is optional.
1073 delay = simple_strtoul(argv[4], NULL, 10);
1078 #ifdef CONFIG_DM_I2C
1079 ret = dm_i2c_read(dev, addr, bytes, length);
1081 ret = i2c_read(chip, addr, alen, bytes, length);
1084 i2c_report_err(ret, I2C_ERR_READ);
1093 * The SDRAM command is separately configured because many
1094 * (most?) embedded boards don't use SDRAM DIMMs.
1096 * FIXME: Document and probably move elsewhere!
1098 #if defined(CONFIG_CMD_SDRAM)
1099 static void print_ddr2_tcyc (u_char const b)
1101 printf ("%d.", (b >> 4) & 0x0F);
1113 printf ("%d ns\n", b & 0x0F);
1133 static void decode_bits (u_char const b, char const *str[], int const do_once)
1137 for (mask = 0x80; mask != 0x00; mask >>= 1, ++str) {
1148 * i2c sdram {i2c_chip}
1150 static int do_sdram (cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1152 enum { unknown, EDO, SDRAM, DDR, DDR2, DDR3, DDR4 } type;
1158 #ifdef CONFIG_DM_I2C
1159 struct udevice *dev;
1162 static const char *decode_CAS_DDR2[] = {
1163 " TBD", " 6", " 5", " 4", " 3", " 2", " TBD", " TBD"
1166 static const char *decode_CAS_default[] = {
1167 " TBD", " 7", " 6", " 5", " 4", " 3", " 2", " 1"
1170 static const char *decode_CS_WE_default[] = {
1171 " TBD", " 6", " 5", " 4", " 3", " 2", " 1", " 0"
1174 static const char *decode_byte21_default[] = {
1176 " Redundant row address\n",
1177 " Differential clock input\n",
1178 " Registerd DQMB inputs\n",
1179 " Buffered DQMB inputs\n",
1181 " Registered address/control lines\n",
1182 " Buffered address/control lines\n"
1185 static const char *decode_byte22_DDR2[] = {
1191 " Supports partial array self refresh\n",
1192 " Supports 50 ohm ODT\n",
1193 " Supports weak driver\n"
1196 static const char *decode_row_density_DDR2[] = {
1197 "512 MiB", "256 MiB", "128 MiB", "16 GiB",
1198 "8 GiB", "4 GiB", "2 GiB", "1 GiB"
1201 static const char *decode_row_density_default[] = {
1202 "512 MiB", "256 MiB", "128 MiB", "64 MiB",
1203 "32 MiB", "16 MiB", "8 MiB", "4 MiB"
1207 return CMD_RET_USAGE;
1210 * Chip is always specified.
1212 chip = simple_strtoul (argv[1], NULL, 16);
1214 #ifdef CONFIG_DM_I2C
1215 ret = i2c_get_cur_bus_chip(chip, &dev);
1217 ret = dm_i2c_read(dev, 0, data, sizeof(data));
1219 ret = i2c_read(chip, 0, 1, data, sizeof(data));
1222 puts ("No SDRAM Serial Presence Detect found.\n");
1227 for (j = 0; j < 63; j++) {
1230 if (cksum != data[63]) {
1231 printf ("WARNING: Configuration data checksum failure:\n"
1232 " is 0x%02x, calculated 0x%02x\n", data[63], cksum);
1234 printf ("SPD data revision %d.%d\n",
1235 (data[62] >> 4) & 0x0F, data[62] & 0x0F);
1236 printf ("Bytes used 0x%02X\n", data[0]);
1237 printf ("Serial memory size 0x%02X\n", 1 << data[1]);
1239 puts ("Memory type ");
1271 puts ("Row address bits ");
1272 if ((data[3] & 0x00F0) == 0)
1273 printf ("%d\n", data[3] & 0x0F);
1275 printf ("%d/%d\n", data[3] & 0x0F, (data[3] >> 4) & 0x0F);
1277 puts ("Column address bits ");
1278 if ((data[4] & 0x00F0) == 0)
1279 printf ("%d\n", data[4] & 0x0F);
1281 printf ("%d/%d\n", data[4] & 0x0F, (data[4] >> 4) & 0x0F);
1285 printf ("Number of ranks %d\n",
1286 (data[5] & 0x07) + 1);
1289 printf ("Module rows %d\n", data[5]);
1295 printf ("Module data width %d bits\n", data[6]);
1298 printf ("Module data width %d bits\n",
1299 (data[7] << 8) | data[6]);
1303 puts ("Interface signal levels ");
1305 case 0: puts ("TTL 5.0 V\n"); break;
1306 case 1: puts ("LVTTL\n"); break;
1307 case 2: puts ("HSTL 1.5 V\n"); break;
1308 case 3: puts ("SSTL 3.3 V\n"); break;
1309 case 4: puts ("SSTL 2.5 V\n"); break;
1310 case 5: puts ("SSTL 1.8 V\n"); break;
1311 default: puts ("unknown\n"); break;
1316 printf ("SDRAM cycle time ");
1317 print_ddr2_tcyc (data[9]);
1320 printf ("SDRAM cycle time %d.%d ns\n",
1321 (data[9] >> 4) & 0x0F, data[9] & 0x0F);
1327 printf ("SDRAM access time 0.%d%d ns\n",
1328 (data[10] >> 4) & 0x0F, data[10] & 0x0F);
1331 printf ("SDRAM access time %d.%d ns\n",
1332 (data[10] >> 4) & 0x0F, data[10] & 0x0F);
1336 puts ("EDC configuration ");
1338 case 0: puts ("None\n"); break;
1339 case 1: puts ("Parity\n"); break;
1340 case 2: puts ("ECC\n"); break;
1341 default: puts ("unknown\n"); break;
1344 if ((data[12] & 0x80) == 0)
1345 puts ("No self refresh, rate ");
1347 puts ("Self refresh, rate ");
1349 switch(data[12] & 0x7F) {
1350 case 0: puts ("15.625 us\n"); break;
1351 case 1: puts ("3.9 us\n"); break;
1352 case 2: puts ("7.8 us\n"); break;
1353 case 3: puts ("31.3 us\n"); break;
1354 case 4: puts ("62.5 us\n"); break;
1355 case 5: puts ("125 us\n"); break;
1356 default: puts ("unknown\n"); break;
1361 printf ("SDRAM width (primary) %d\n", data[13]);
1364 printf ("SDRAM width (primary) %d\n", data[13] & 0x7F);
1365 if ((data[13] & 0x80) != 0) {
1366 printf (" (second bank) %d\n",
1367 2 * (data[13] & 0x7F));
1375 printf ("EDC width %d\n", data[14]);
1378 if (data[14] != 0) {
1379 printf ("EDC width %d\n",
1382 if ((data[14] & 0x80) != 0) {
1383 printf (" (second bank) %d\n",
1384 2 * (data[14] & 0x7F));
1391 printf ("Min clock delay, back-to-back random column addresses "
1395 puts ("Burst length(s) ");
1396 if (data[16] & 0x80) puts (" Page");
1397 if (data[16] & 0x08) puts (" 8");
1398 if (data[16] & 0x04) puts (" 4");
1399 if (data[16] & 0x02) puts (" 2");
1400 if (data[16] & 0x01) puts (" 1");
1402 printf ("Number of banks %d\n", data[17]);
1406 puts ("CAS latency(s) ");
1407 decode_bits (data[18], decode_CAS_DDR2, 0);
1411 puts ("CAS latency(s) ");
1412 decode_bits (data[18], decode_CAS_default, 0);
1418 puts ("CS latency(s) ");
1419 decode_bits (data[19], decode_CS_WE_default, 0);
1424 puts ("WE latency(s) ");
1425 decode_bits (data[20], decode_CS_WE_default, 0);
1431 puts ("Module attributes:\n");
1432 if (data[21] & 0x80)
1433 puts (" TBD (bit 7)\n");
1434 if (data[21] & 0x40)
1435 puts (" Analysis probe installed\n");
1436 if (data[21] & 0x20)
1437 puts (" TBD (bit 5)\n");
1438 if (data[21] & 0x10)
1439 puts (" FET switch external enable\n");
1440 printf (" %d PLLs on DIMM\n", (data[21] >> 2) & 0x03);
1441 if (data[20] & 0x11) {
1442 printf (" %d active registers on DIMM\n",
1443 (data[21] & 0x03) + 1);
1447 puts ("Module attributes:\n");
1451 decode_bits (data[21], decode_byte21_default, 0);
1457 decode_bits (data[22], decode_byte22_DDR2, 0);
1460 puts ("Device attributes:\n");
1461 if (data[22] & 0x80) puts (" TBD (bit 7)\n");
1462 if (data[22] & 0x40) puts (" TBD (bit 6)\n");
1463 if (data[22] & 0x20) puts (" Upper Vcc tolerance 5%\n");
1464 else puts (" Upper Vcc tolerance 10%\n");
1465 if (data[22] & 0x10) puts (" Lower Vcc tolerance 5%\n");
1466 else puts (" Lower Vcc tolerance 10%\n");
1467 if (data[22] & 0x08) puts (" Supports write1/read burst\n");
1468 if (data[22] & 0x04) puts (" Supports precharge all\n");
1469 if (data[22] & 0x02) puts (" Supports auto precharge\n");
1470 if (data[22] & 0x01) puts (" Supports early RAS# precharge\n");
1476 printf ("SDRAM cycle time (2nd highest CAS latency) ");
1477 print_ddr2_tcyc (data[23]);
1480 printf ("SDRAM cycle time (2nd highest CAS latency) %d."
1481 "%d ns\n", (data[23] >> 4) & 0x0F, data[23] & 0x0F);
1487 printf ("SDRAM access from clock (2nd highest CAS latency) 0."
1488 "%d%d ns\n", (data[24] >> 4) & 0x0F, data[24] & 0x0F);
1491 printf ("SDRAM access from clock (2nd highest CAS latency) %d."
1492 "%d ns\n", (data[24] >> 4) & 0x0F, data[24] & 0x0F);
1498 printf ("SDRAM cycle time (3rd highest CAS latency) ");
1499 print_ddr2_tcyc (data[25]);
1502 printf ("SDRAM cycle time (3rd highest CAS latency) %d."
1503 "%d ns\n", (data[25] >> 4) & 0x0F, data[25] & 0x0F);
1509 printf ("SDRAM access from clock (3rd highest CAS latency) 0."
1510 "%d%d ns\n", (data[26] >> 4) & 0x0F, data[26] & 0x0F);
1513 printf ("SDRAM access from clock (3rd highest CAS latency) %d."
1514 "%d ns\n", (data[26] >> 4) & 0x0F, data[26] & 0x0F);
1520 printf ("Minimum row precharge %d.%02d ns\n",
1521 (data[27] >> 2) & 0x3F, 25 * (data[27] & 0x03));
1524 printf ("Minimum row precharge %d ns\n", data[27]);
1530 printf ("Row active to row active min %d.%02d ns\n",
1531 (data[28] >> 2) & 0x3F, 25 * (data[28] & 0x03));
1534 printf ("Row active to row active min %d ns\n", data[28]);
1540 printf ("RAS to CAS delay min %d.%02d ns\n",
1541 (data[29] >> 2) & 0x3F, 25 * (data[29] & 0x03));
1544 printf ("RAS to CAS delay min %d ns\n", data[29]);
1548 printf ("Minimum RAS pulse width %d ns\n", data[30]);
1552 puts ("Density of each row ");
1553 decode_bits (data[31], decode_row_density_DDR2, 1);
1557 puts ("Density of each row ");
1558 decode_bits (data[31], decode_row_density_default, 1);
1565 puts ("Command and Address setup ");
1566 if (data[32] >= 0xA0) {
1567 printf ("1.%d%d ns\n",
1568 ((data[32] >> 4) & 0x0F) - 10, data[32] & 0x0F);
1570 printf ("0.%d%d ns\n",
1571 ((data[32] >> 4) & 0x0F), data[32] & 0x0F);
1575 printf ("Command and Address setup %c%d.%d ns\n",
1576 (data[32] & 0x80) ? '-' : '+',
1577 (data[32] >> 4) & 0x07, data[32] & 0x0F);
1583 puts ("Command and Address hold ");
1584 if (data[33] >= 0xA0) {
1585 printf ("1.%d%d ns\n",
1586 ((data[33] >> 4) & 0x0F) - 10, data[33] & 0x0F);
1588 printf ("0.%d%d ns\n",
1589 ((data[33] >> 4) & 0x0F), data[33] & 0x0F);
1593 printf ("Command and Address hold %c%d.%d ns\n",
1594 (data[33] & 0x80) ? '-' : '+',
1595 (data[33] >> 4) & 0x07, data[33] & 0x0F);
1601 printf ("Data signal input setup 0.%d%d ns\n",
1602 (data[34] >> 4) & 0x0F, data[34] & 0x0F);
1605 printf ("Data signal input setup %c%d.%d ns\n",
1606 (data[34] & 0x80) ? '-' : '+',
1607 (data[34] >> 4) & 0x07, data[34] & 0x0F);
1613 printf ("Data signal input hold 0.%d%d ns\n",
1614 (data[35] >> 4) & 0x0F, data[35] & 0x0F);
1617 printf ("Data signal input hold %c%d.%d ns\n",
1618 (data[35] & 0x80) ? '-' : '+',
1619 (data[35] >> 4) & 0x07, data[35] & 0x0F);
1623 puts ("Manufacturer's JEDEC ID ");
1624 for (j = 64; j <= 71; j++)
1625 printf ("%02X ", data[j]);
1627 printf ("Manufacturing Location %02X\n", data[72]);
1628 puts ("Manufacturer's Part Number ");
1629 for (j = 73; j <= 90; j++)
1630 printf ("%02X ", data[j]);
1632 printf ("Revision Code %02X %02X\n", data[91], data[92]);
1633 printf ("Manufacturing Date %02X %02X\n", data[93], data[94]);
1634 puts ("Assembly Serial Number ");
1635 for (j = 95; j <= 98; j++)
1636 printf ("%02X ", data[j]);
1640 printf ("Speed rating PC%d\n",
1641 data[126] == 0x66 ? 66 : data[126]);
1649 * i2c edid {i2c_chip}
1651 #if defined(CONFIG_I2C_EDID)
1652 int do_edid(cmd_tbl_t *cmdtp, int flag, int argc, char *const argv[])
1655 struct edid1_info edid;
1657 #ifdef CONFIG_DM_I2C
1658 struct udevice *dev;
1666 chip = simple_strtoul(argv[1], NULL, 16);
1667 #ifdef CONFIG_DM_I2C
1668 ret = i2c_get_cur_bus_chip(chip, &dev);
1670 ret = dm_i2c_read(dev, 0, (uchar *)&edid, sizeof(edid));
1672 ret = i2c_read(chip, 0, 1, (uchar *)&edid, sizeof(edid));
1675 return i2c_report_err(ret, I2C_ERR_READ);
1677 if (edid_check_info(&edid)) {
1678 puts("Content isn't valid EDID.\n");
1682 edid_print_info(&edid);
1686 #endif /* CONFIG_I2C_EDID */
1688 #ifdef CONFIG_DM_I2C
1689 static void show_bus(struct udevice *bus)
1691 struct udevice *dev;
1693 printf("Bus %d:\t%s", bus->req_seq, bus->name);
1694 if (device_active(bus))
1695 printf(" (active %d)", bus->seq);
1697 for (device_find_first_child(bus, &dev);
1699 device_find_next_child(&dev)) {
1700 struct dm_i2c_chip *chip = dev_get_parent_platdata(dev);
1702 printf(" %02x: %s, offset len %x, flags %x\n",
1703 chip->chip_addr, dev->name, chip->offset_len,
1710 * do_i2c_show_bus() - Handle the "i2c bus" command-line command
1711 * @cmdtp: Command data struct pointer
1712 * @flag: Command flag
1713 * @argc: Command-line argument count
1714 * @argv: Array of command-line arguments
1716 * Returns zero always.
1718 #if defined(CONFIG_SYS_I2C) || defined(CONFIG_DM_I2C)
1719 static int do_i2c_show_bus(cmd_tbl_t *cmdtp, int flag, int argc,
1720 char * const argv[])
1723 /* show all busses */
1724 #ifdef CONFIG_DM_I2C
1725 struct udevice *bus;
1729 ret = uclass_get(UCLASS_I2C, &uc);
1731 return CMD_RET_FAILURE;
1732 uclass_foreach_dev(bus, uc)
1737 for (i = 0; i < CONFIG_SYS_NUM_I2C_BUSES; i++) {
1738 printf("Bus %d:\t%s", i, I2C_ADAP_NR(i)->name);
1739 #ifndef CONFIG_SYS_I2C_DIRECT_BUS
1742 for (j = 0; j < CONFIG_SYS_I2C_MAX_HOPS; j++) {
1743 if (i2c_bus[i].next_hop[j].chip == 0)
1745 printf("->%s@0x%2x:%d",
1746 i2c_bus[i].next_hop[j].mux.name,
1747 i2c_bus[i].next_hop[j].chip,
1748 i2c_bus[i].next_hop[j].channel);
1757 /* show specific bus */
1758 i = simple_strtoul(argv[1], NULL, 10);
1759 #ifdef CONFIG_DM_I2C
1760 struct udevice *bus;
1763 ret = uclass_get_device_by_seq(UCLASS_I2C, i, &bus);
1765 printf("Invalid bus %d: err=%d\n", i, ret);
1766 return CMD_RET_FAILURE;
1770 if (i >= CONFIG_SYS_NUM_I2C_BUSES) {
1771 printf("Invalid bus %d\n", i);
1774 printf("Bus %d:\t%s", i, I2C_ADAP_NR(i)->name);
1775 #ifndef CONFIG_SYS_I2C_DIRECT_BUS
1777 for (j = 0; j < CONFIG_SYS_I2C_MAX_HOPS; j++) {
1778 if (i2c_bus[i].next_hop[j].chip == 0)
1780 printf("->%s@0x%2x:%d",
1781 i2c_bus[i].next_hop[j].mux.name,
1782 i2c_bus[i].next_hop[j].chip,
1783 i2c_bus[i].next_hop[j].channel);
1795 * do_i2c_bus_num() - Handle the "i2c dev" command-line command
1796 * @cmdtp: Command data struct pointer
1797 * @flag: Command flag
1798 * @argc: Command-line argument count
1799 * @argv: Array of command-line arguments
1801 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1804 #if defined(CONFIG_SYS_I2C) || defined(CONFIG_I2C_MULTI_BUS) || \
1805 defined(CONFIG_DM_I2C)
1806 static int do_i2c_bus_num(cmd_tbl_t *cmdtp, int flag, int argc,
1807 char * const argv[])
1813 /* querying current setting */
1814 #ifdef CONFIG_DM_I2C
1815 struct udevice *bus;
1817 if (!i2c_get_cur_bus(&bus))
1822 bus_no = i2c_get_bus_num();
1824 printf("Current bus is %d\n", bus_no);
1826 bus_no = simple_strtoul(argv[1], NULL, 10);
1827 #if defined(CONFIG_SYS_I2C)
1828 if (bus_no >= CONFIG_SYS_NUM_I2C_BUSES) {
1829 printf("Invalid bus %d\n", bus_no);
1833 printf("Setting bus to %d\n", bus_no);
1834 #ifdef CONFIG_DM_I2C
1835 ret = cmd_i2c_set_bus_num(bus_no);
1837 ret = i2c_set_bus_num(bus_no);
1840 printf("Failure changing bus number (%d)\n", ret);
1843 return ret ? CMD_RET_FAILURE : 0;
1845 #endif /* defined(CONFIG_SYS_I2C) */
1848 * do_i2c_bus_speed() - Handle the "i2c speed" command-line command
1849 * @cmdtp: Command data struct pointer
1850 * @flag: Command flag
1851 * @argc: Command-line argument count
1852 * @argv: Array of command-line arguments
1854 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1857 static int do_i2c_bus_speed(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1861 #ifdef CONFIG_DM_I2C
1862 struct udevice *bus;
1864 if (i2c_get_cur_bus(&bus))
1868 #ifdef CONFIG_DM_I2C
1869 speed = dm_i2c_get_bus_speed(bus);
1871 speed = i2c_get_bus_speed();
1873 /* querying current speed */
1874 printf("Current bus speed=%d\n", speed);
1876 speed = simple_strtoul(argv[1], NULL, 10);
1877 printf("Setting bus speed to %d Hz\n", speed);
1878 #ifdef CONFIG_DM_I2C
1879 ret = dm_i2c_set_bus_speed(bus, speed);
1881 ret = i2c_set_bus_speed(speed);
1884 printf("Failure changing bus speed (%d)\n", ret);
1887 return ret ? CMD_RET_FAILURE : 0;
1891 * do_i2c_mm() - Handle the "i2c mm" command-line command
1892 * @cmdtp: Command data struct pointer
1893 * @flag: Command flag
1894 * @argc: Command-line argument count
1895 * @argv: Array of command-line arguments
1897 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1900 static int do_i2c_mm(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1902 return mod_i2c_mem (cmdtp, 1, flag, argc, argv);
1906 * do_i2c_nm() - Handle the "i2c nm" command-line command
1907 * @cmdtp: Command data struct pointer
1908 * @flag: Command flag
1909 * @argc: Command-line argument count
1910 * @argv: Array of command-line arguments
1912 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1915 static int do_i2c_nm(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1917 return mod_i2c_mem (cmdtp, 0, flag, argc, argv);
1921 * do_i2c_reset() - Handle the "i2c reset" command-line command
1922 * @cmdtp: Command data struct pointer
1923 * @flag: Command flag
1924 * @argc: Command-line argument count
1925 * @argv: Array of command-line arguments
1927 * Returns zero always.
1929 static int do_i2c_reset(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1931 #if defined(CONFIG_DM_I2C)
1932 struct udevice *bus;
1934 if (i2c_get_cur_bus(&bus))
1935 return CMD_RET_FAILURE;
1936 if (i2c_deblock(bus)) {
1937 printf("Error: Not supported by the driver\n");
1938 return CMD_RET_FAILURE;
1940 #elif defined(CONFIG_SYS_I2C)
1941 i2c_init(I2C_ADAP->speed, I2C_ADAP->slaveaddr);
1943 i2c_init(CONFIG_SYS_I2C_SPEED, CONFIG_SYS_I2C_SLAVE);
1948 static cmd_tbl_t cmd_i2c_sub[] = {
1949 #if defined(CONFIG_SYS_I2C) || defined(CONFIG_DM_I2C)
1950 U_BOOT_CMD_MKENT(bus, 1, 1, do_i2c_show_bus, "", ""),
1952 U_BOOT_CMD_MKENT(crc32, 3, 1, do_i2c_crc, "", ""),
1953 #if defined(CONFIG_SYS_I2C) || \
1954 defined(CONFIG_I2C_MULTI_BUS) || defined(CONFIG_DM_I2C)
1955 U_BOOT_CMD_MKENT(dev, 1, 1, do_i2c_bus_num, "", ""),
1956 #endif /* CONFIG_I2C_MULTI_BUS */
1957 #if defined(CONFIG_I2C_EDID)
1958 U_BOOT_CMD_MKENT(edid, 1, 1, do_edid, "", ""),
1959 #endif /* CONFIG_I2C_EDID */
1960 U_BOOT_CMD_MKENT(loop, 3, 1, do_i2c_loop, "", ""),
1961 U_BOOT_CMD_MKENT(md, 3, 1, do_i2c_md, "", ""),
1962 U_BOOT_CMD_MKENT(mm, 2, 1, do_i2c_mm, "", ""),
1963 U_BOOT_CMD_MKENT(mw, 3, 1, do_i2c_mw, "", ""),
1964 U_BOOT_CMD_MKENT(nm, 2, 1, do_i2c_nm, "", ""),
1965 U_BOOT_CMD_MKENT(probe, 0, 1, do_i2c_probe, "", ""),
1966 U_BOOT_CMD_MKENT(read, 5, 1, do_i2c_read, "", ""),
1967 U_BOOT_CMD_MKENT(write, 6, 0, do_i2c_write, "", ""),
1968 #ifdef CONFIG_DM_I2C
1969 U_BOOT_CMD_MKENT(flags, 2, 1, do_i2c_flags, "", ""),
1970 U_BOOT_CMD_MKENT(olen, 2, 1, do_i2c_olen, "", ""),
1972 U_BOOT_CMD_MKENT(reset, 0, 1, do_i2c_reset, "", ""),
1973 #if defined(CONFIG_CMD_SDRAM)
1974 U_BOOT_CMD_MKENT(sdram, 1, 1, do_sdram, "", ""),
1976 U_BOOT_CMD_MKENT(speed, 1, 1, do_i2c_bus_speed, "", ""),
1979 static __maybe_unused void i2c_reloc(void)
1981 static int relocated;
1984 fixup_cmdtable(cmd_i2c_sub, ARRAY_SIZE(cmd_i2c_sub));
1990 * do_i2c() - Handle the "i2c" command-line command
1991 * @cmdtp: Command data struct pointer
1992 * @flag: Command flag
1993 * @argc: Command-line argument count
1994 * @argv: Array of command-line arguments
1996 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1999 static int do_i2c(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
2003 #ifdef CONFIG_NEEDS_MANUAL_RELOC
2008 return CMD_RET_USAGE;
2010 /* Strip off leading 'i2c' command argument */
2014 c = find_cmd_tbl(argv[0], &cmd_i2c_sub[0], ARRAY_SIZE(cmd_i2c_sub));
2017 return c->cmd(cmdtp, flag, argc, argv);
2019 return CMD_RET_USAGE;
2022 /***************************************************/
2023 #ifdef CONFIG_SYS_LONGHELP
2024 static char i2c_help_text[] =
2025 #if defined(CONFIG_SYS_I2C) || defined(CONFIG_DM_I2C)
2026 "bus [muxtype:muxaddr:muxchannel] - show I2C bus info\n"
2028 "crc32 chip address[.0, .1, .2] count - compute CRC32 checksum\n"
2029 #if defined(CONFIG_SYS_I2C) || \
2030 defined(CONFIG_I2C_MULTI_BUS) || defined(CONFIG_DM_I2C)
2031 "i2c dev [dev] - show or set current I2C bus\n"
2032 #endif /* CONFIG_I2C_MULTI_BUS */
2033 #if defined(CONFIG_I2C_EDID)
2034 "i2c edid chip - print EDID configuration information\n"
2035 #endif /* CONFIG_I2C_EDID */
2036 "i2c loop chip address[.0, .1, .2] [# of objects] - looping read of device\n"
2037 "i2c md chip address[.0, .1, .2] [# of objects] - read from I2C device\n"
2038 "i2c mm chip address[.0, .1, .2] - write to I2C device (auto-incrementing)\n"
2039 "i2c mw chip address[.0, .1, .2] value [count] - write to I2C device (fill)\n"
2040 "i2c nm chip address[.0, .1, .2] - write to I2C device (constant address)\n"
2041 "i2c probe [address] - test for and show device(s) on the I2C bus\n"
2042 "i2c read chip address[.0, .1, .2] length memaddress - read to memory\n"
2043 "i2c write memaddress chip address[.0, .1, .2] length [-s] - write memory\n"
2044 " to I2C; the -s option selects bulk write in a single transaction\n"
2045 #ifdef CONFIG_DM_I2C
2046 "i2c flags chip [flags] - set or get chip flags\n"
2047 "i2c olen chip [offset_length] - set or get chip offset length\n"
2049 "i2c reset - re-init the I2C Controller\n"
2050 #if defined(CONFIG_CMD_SDRAM)
2051 "i2c sdram chip - print SDRAM configuration information\n"
2053 "i2c speed [speed] - show or set I2C bus speed";