1 // SPDX-License-Identifier: GPL-2.0+
4 * Sergey Kubushyn, himself, ksi@koi8.net
6 * Changes for unified multibus/multiadapter I2C support.
9 * Gerald Van Baren, Custom IDEAS, vanbaren@cideas.com.
13 * I2C Functions similar to the standard memory functions.
15 * There are several parameters in many of the commands that bear further
18 * {i2c_chip} is the I2C chip address (the first byte sent on the bus).
19 * Each I2C chip on the bus has a unique address. On the I2C data bus,
20 * the address is the upper seven bits and the LSB is the "read/write"
21 * bit. Note that the {i2c_chip} address specified on the command
22 * line is not shifted up: e.g. a typical EEPROM memory chip may have
23 * an I2C address of 0x50, but the data put on the bus will be 0xA0
24 * for write and 0xA1 for read. This "non shifted" address notation
25 * matches at least half of the data sheets :-/.
27 * {addr} is the address (or offset) within the chip. Small memory
28 * chips have 8 bit addresses. Large memory chips have 16 bit
29 * addresses. Other memory chips have 9, 10, or 11 bit addresses.
30 * Many non-memory chips have multiple registers and {addr} is used
31 * as the register index. Some non-memory chips have only one register
32 * and therefore don't need any {addr} parameter.
34 * The default {addr} parameter is one byte (.1) which works well for
35 * memories and registers with 8 bits of address space.
37 * You can specify the length of the {addr} field with the optional .0,
38 * .1, or .2 modifier (similar to the .b, .w, .l modifier). If you are
39 * manipulating a single register device which doesn't use an address
40 * field, use "0.0" for the address and the ".0" length field will
41 * suppress the address in the I2C data stream. This also works for
42 * successive reads using the I2C auto-incrementing memory pointer.
44 * If you are manipulating a large memory with 2-byte addresses, use
45 * the .2 address modifier, e.g. 210.2 addresses location 528 (decimal).
47 * Then there are the unfortunate memory chips that spill the most
48 * significant 1, 2, or 3 bits of address into the chip address byte.
49 * This effectively makes one chip (logically) look like 2, 4, or
50 * 8 chips. This is handled (awkwardly) by #defining
51 * CONFIG_SYS_I2C_EEPROM_ADDR_OVERFLOW and using the .1 modifier on the
52 * {addr} field (since .1 is the default, it doesn't actually have to
53 * be specified). Examples: given a memory chip at I2C chip address
54 * 0x50, the following would happen...
55 * i2c md 50 0 10 display 16 bytes starting at 0x000
56 * On the bus: <S> A0 00 <E> <S> A1 <rd> ... <rd>
57 * i2c md 50 100 10 display 16 bytes starting at 0x100
58 * On the bus: <S> A2 00 <E> <S> A3 <rd> ... <rd>
59 * i2c md 50 210 10 display 16 bytes starting at 0x210
60 * On the bus: <S> A4 10 <E> <S> A5 <rd> ... <rd>
61 * This is awfully ugly. It would be nice if someone would think up
62 * a better way of handling this.
64 * Adapted from cmd_mem.c which is copyright Wolfgang Denk (wd@denx.de).
67 #include <bootretry.h>
77 #include <asm/byteorder.h>
78 #include <linux/compiler.h>
79 #include <linux/delay.h>
80 #include <u-boot/crc.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(CFG_SYS_I2C_NOPROBES)
100 #if CONFIG_IS_ENABLED(SYS_I2C_LEGACY)
105 } i2c_no_probes
[] = CFG_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
[] = CFG_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 /* CONFIG_IS_ENABLED(SYS_I2C_LEGACY) */
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
126 #if CONFIG_IS_ENABLED(DM_I2C)
127 #define DEFAULT_ADDR_LEN (-1)
129 #define DEFAULT_ADDR_LEN 1
132 #if CONFIG_IS_ENABLED(DM_I2C)
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)
198 * get_alen() - Small parser helper function to get address length
200 * Returns the address length.
202 static uint
get_alen(char *arg
, int default_len
)
208 for (j
= 0; j
< 8; j
++) {
210 alen
= arg
[j
+1] - '0';
212 } else if (arg
[j
] == '\0')
223 static int i2c_report_err(int ret
, enum i2c_err_op op
)
225 printf("Error %s the chip: %d\n",
226 op
== I2C_ERR_READ
? "reading" : "writing", ret
);
228 return CMD_RET_FAILURE
;
232 * do_i2c_read() - Handle the "i2c read" command-line command
233 * @cmdtp: Command data struct pointer
234 * @flag: Command flag
235 * @argc: Command-line argument count
236 * @argv: Array of command-line arguments
238 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
242 * i2c read {i2c_chip} {devaddr}{.0, .1, .2} {len} {memaddr}
244 static int do_i2c_read(struct cmd_tbl
*cmdtp
, int flag
, int argc
,
248 uint devaddr
, length
;
252 #if CONFIG_IS_ENABLED(DM_I2C)
257 return CMD_RET_USAGE
;
262 chip
= hextoul(argv
[1], NULL
);
265 * I2C data address within the chip. This can be 1 or
266 * 2 bytes long. Some day it might be 3 bytes long :-).
268 devaddr
= hextoul(argv
[2], NULL
);
269 alen
= get_alen(argv
[2], DEFAULT_ADDR_LEN
);
271 return CMD_RET_USAGE
;
274 * Length is the number of objects, not number of bytes.
276 length
= hextoul(argv
[3], NULL
);
279 * memaddr is the address where to store things in memory
281 memaddr
= (u_char
*)hextoul(argv
[4], NULL
);
283 #if CONFIG_IS_ENABLED(DM_I2C)
284 ret
= i2c_get_cur_bus_chip(chip
, &dev
);
285 if (!ret
&& alen
!= -1)
286 ret
= i2c_set_chip_offset_len(dev
, alen
);
288 ret
= dm_i2c_read(dev
, devaddr
, memaddr
, length
);
290 ret
= i2c_read(chip
, devaddr
, alen
, memaddr
, length
);
293 return i2c_report_err(ret
, I2C_ERR_READ
);
298 static int do_i2c_write(struct cmd_tbl
*cmdtp
, int flag
, int argc
,
302 uint devaddr
, length
;
306 #if CONFIG_IS_ENABLED(DM_I2C)
308 struct dm_i2c_chip
*i2c_chip
;
311 if ((argc
< 5) || (argc
> 6))
312 return cmd_usage(cmdtp
);
315 * memaddr is the address where to store things in memory
317 memaddr
= (u_char
*)hextoul(argv
[1], NULL
);
322 chip
= hextoul(argv
[2], NULL
);
325 * I2C data address within the chip. This can be 1 or
326 * 2 bytes long. Some day it might be 3 bytes long :-).
328 devaddr
= hextoul(argv
[3], NULL
);
329 alen
= get_alen(argv
[3], DEFAULT_ADDR_LEN
);
331 return cmd_usage(cmdtp
);
334 * Length is the number of bytes.
336 length
= hextoul(argv
[4], NULL
);
338 #if CONFIG_IS_ENABLED(DM_I2C)
339 ret
= i2c_get_cur_bus_chip(chip
, &dev
);
340 if (!ret
&& alen
!= -1)
341 ret
= i2c_set_chip_offset_len(dev
, alen
);
343 return i2c_report_err(ret
, I2C_ERR_WRITE
);
344 i2c_chip
= dev_get_parent_plat(dev
);
346 return i2c_report_err(ret
, I2C_ERR_WRITE
);
349 if (argc
== 6 && !strcmp(argv
[5], "-s")) {
351 * Write all bytes in a single I2C transaction. If the target
352 * device is an EEPROM, it is your responsibility to not cross
353 * a page boundary. No write delay upon completion, take this
354 * into account if linking commands.
356 #if CONFIG_IS_ENABLED(DM_I2C)
357 i2c_chip
->flags
&= ~DM_I2C_CHIP_WR_ADDRESS
;
358 ret
= dm_i2c_write(dev
, devaddr
, memaddr
, length
);
360 ret
= i2c_write(chip
, devaddr
, alen
, memaddr
, length
);
363 return i2c_report_err(ret
, I2C_ERR_WRITE
);
366 * Repeated addressing - perform <length> separate
367 * write transactions of one byte each
369 while (length
-- > 0) {
370 #if CONFIG_IS_ENABLED(DM_I2C)
371 i2c_chip
->flags
|= DM_I2C_CHIP_WR_ADDRESS
;
372 ret
= dm_i2c_write(dev
, devaddr
++, memaddr
++, 1);
374 ret
= i2c_write(chip
, devaddr
++, alen
, memaddr
++, 1);
377 return i2c_report_err(ret
, I2C_ERR_WRITE
);
379 * No write delay with FRAM devices.
381 #if !defined(CONFIG_SYS_I2C_FRAM)
389 #if CONFIG_IS_ENABLED(DM_I2C)
390 static int do_i2c_flags(struct cmd_tbl
*cmdtp
, int flag
, int argc
,
399 return CMD_RET_USAGE
;
401 chip
= hextoul(argv
[1], NULL
);
402 ret
= i2c_get_cur_bus_chip(chip
, &dev
);
404 return i2c_report_err(ret
, I2C_ERR_READ
);
407 flags
= hextoul(argv
[2], NULL
);
408 ret
= i2c_set_chip_flags(dev
, flags
);
410 ret
= i2c_get_chip_flags(dev
, &flags
);
412 printf("%x\n", flags
);
415 return i2c_report_err(ret
, I2C_ERR_READ
);
420 static int do_i2c_olen(struct cmd_tbl
*cmdtp
, int flag
, int argc
,
429 return CMD_RET_USAGE
;
431 chip
= hextoul(argv
[1], NULL
);
432 ret
= i2c_get_cur_bus_chip(chip
, &dev
);
434 return i2c_report_err(ret
, I2C_ERR_READ
);
437 olen
= hextoul(argv
[2], NULL
);
438 ret
= i2c_set_chip_offset_len(dev
, olen
);
440 ret
= i2c_get_chip_offset_len(dev
);
447 return i2c_report_err(ret
, I2C_ERR_READ
);
454 * do_i2c_md() - Handle the "i2c md" command-line command
455 * @cmdtp: Command data struct pointer
456 * @flag: Command flag
457 * @argc: Command-line argument count
458 * @argv: Array of command-line arguments
460 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
464 * i2c md {i2c_chip} {addr}{.0, .1, .2} {len}
466 static int do_i2c_md(struct cmd_tbl
*cmdtp
, int flag
, int argc
,
473 uint nbytes
, linebytes
;
475 #if CONFIG_IS_ENABLED(DM_I2C)
479 /* We use the last specified parameters, unless new ones are
482 chip
= i2c_dp_last_chip
;
483 addr
= i2c_dp_last_addr
;
484 alen
= i2c_dp_last_alen
;
485 length
= i2c_dp_last_length
;
488 return CMD_RET_USAGE
;
490 if ((flag
& CMD_FLAG_REPEAT
) == 0) {
492 * New command specified.
498 chip
= hextoul(argv
[1], NULL
);
501 * I2C data address within the chip. This can be 1 or
502 * 2 bytes long. Some day it might be 3 bytes long :-).
504 addr
= hextoul(argv
[2], NULL
);
505 alen
= get_alen(argv
[2], DEFAULT_ADDR_LEN
);
507 return CMD_RET_USAGE
;
510 * If another parameter, it is the length to display.
511 * Length is the number of objects, not number of bytes.
514 length
= hextoul(argv
[3], NULL
);
517 #if CONFIG_IS_ENABLED(DM_I2C)
518 ret
= i2c_get_cur_bus_chip(chip
, &dev
);
519 if (!ret
&& alen
!= -1)
520 ret
= i2c_set_chip_offset_len(dev
, alen
);
522 return i2c_report_err(ret
, I2C_ERR_READ
);
528 * We buffer all read data, so we can make sure data is read only
533 unsigned char linebuf
[DISP_LINE_LEN
];
536 linebytes
= (nbytes
> DISP_LINE_LEN
) ? DISP_LINE_LEN
: nbytes
;
538 #if CONFIG_IS_ENABLED(DM_I2C)
539 ret
= dm_i2c_read(dev
, addr
, linebuf
, linebytes
);
541 ret
= i2c_read(chip
, addr
, alen
, linebuf
, linebytes
);
544 return i2c_report_err(ret
, I2C_ERR_READ
);
546 printf("%04x:", addr
);
548 for (j
=0; j
<linebytes
; j
++) {
549 printf(" %02x", *cp
++);
554 for (j
=0; j
<linebytes
; j
++) {
555 if ((*cp
< 0x20) || (*cp
> 0x7e))
564 } while (nbytes
> 0);
566 i2c_dp_last_chip
= chip
;
567 i2c_dp_last_addr
= addr
;
568 i2c_dp_last_alen
= alen
;
569 i2c_dp_last_length
= length
;
575 * do_i2c_mw() - Handle the "i2c mw" command-line command
576 * @cmdtp: Command data struct pointer
577 * @flag: Command flag
578 * @argc: Command-line argument count
579 * @argv: Array of command-line arguments
581 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
585 * i2c mw {i2c_chip} {addr}{.0, .1, .2} {data} [{count}]
587 static int do_i2c_mw(struct cmd_tbl
*cmdtp
, int flag
, int argc
,
596 #if CONFIG_IS_ENABLED(DM_I2C)
600 if ((argc
< 4) || (argc
> 5))
601 return CMD_RET_USAGE
;
604 * Chip is always specified.
606 chip
= hextoul(argv
[1], NULL
);
609 * Address is always specified.
611 addr
= hextoul(argv
[2], NULL
);
612 alen
= get_alen(argv
[2], DEFAULT_ADDR_LEN
);
614 return CMD_RET_USAGE
;
616 #if CONFIG_IS_ENABLED(DM_I2C)
617 ret
= i2c_get_cur_bus_chip(chip
, &dev
);
618 if (!ret
&& alen
!= -1)
619 ret
= i2c_set_chip_offset_len(dev
, alen
);
621 return i2c_report_err(ret
, I2C_ERR_WRITE
);
624 * Value to write is always specified.
626 byte
= hextoul(argv
[3], NULL
);
632 count
= hextoul(argv
[4], NULL
);
636 while (count
-- > 0) {
637 #if CONFIG_IS_ENABLED(DM_I2C)
638 ret
= dm_i2c_write(dev
, addr
++, &byte
, 1);
640 ret
= i2c_write(chip
, addr
++, alen
, &byte
, 1);
643 return i2c_report_err(ret
, I2C_ERR_WRITE
);
645 * Wait for the write to complete. The write can take
646 * up to 10mSec (we allow a little more time).
649 * No write delay with FRAM devices.
651 #if !defined(CONFIG_SYS_I2C_FRAM)
660 * do_i2c_crc() - Handle the "i2c crc32" command-line command
661 * @cmdtp: Command data struct pointer
662 * @flag: Command flag
663 * @argc: Command-line argument count
664 * @argv: Array of command-line arguments
666 * Calculate a CRC on memory
668 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
672 * i2c crc32 {i2c_chip} {addr}{.0, .1, .2} {count}
674 static int do_i2c_crc(struct cmd_tbl
*cmdtp
, int flag
, int argc
,
685 #if CONFIG_IS_ENABLED(DM_I2C)
690 return CMD_RET_USAGE
;
693 * Chip is always specified.
695 chip
= hextoul(argv
[1], NULL
);
698 * Address is always specified.
700 addr
= hextoul(argv
[2], NULL
);
701 alen
= get_alen(argv
[2], DEFAULT_ADDR_LEN
);
703 return CMD_RET_USAGE
;
705 #if CONFIG_IS_ENABLED(DM_I2C)
706 ret
= i2c_get_cur_bus_chip(chip
, &dev
);
707 if (!ret
&& alen
!= -1)
708 ret
= i2c_set_chip_offset_len(dev
, alen
);
710 return i2c_report_err(ret
, I2C_ERR_READ
);
713 * Count is always specified
715 count
= hextoul(argv
[3], NULL
);
717 printf ("CRC32 for %08lx ... %08lx ==> ", addr
, addr
+ count
- 1);
719 * CRC a byte at a time. This is going to be slooow, but hey, the
720 * memories are small and slow too so hopefully nobody notices.
724 while (count
-- > 0) {
725 #if CONFIG_IS_ENABLED(DM_I2C)
726 ret
= dm_i2c_read(dev
, addr
, &byte
, 1);
728 ret
= i2c_read(chip
, addr
, alen
, &byte
, 1);
732 crc
= crc32(crc
, &byte
, 1);
736 i2c_report_err(ret
, I2C_ERR_READ
);
738 printf ("%08lx\n", crc
);
744 * mod_i2c_mem() - Handle the "i2c mm" and "i2c nm" command-line command
745 * @cmdtp: Command data struct pointer
746 * @flag: Command flag
747 * @argc: Command-line argument count
748 * @argv: Array of command-line arguments
752 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
756 * i2c mm{.b, .w, .l} {i2c_chip} {addr}{.0, .1, .2}
757 * i2c nm{.b, .w, .l} {i2c_chip} {addr}{.0, .1, .2}
759 static int mod_i2c_mem(struct cmd_tbl
*cmdtp
, int incrflag
, int flag
, int argc
,
769 #if CONFIG_IS_ENABLED(DM_I2C)
774 return CMD_RET_USAGE
;
776 bootretry_reset_cmd_timeout(); /* got a good command to get here */
778 * We use the last specified parameters, unless new ones are
781 chip
= i2c_mm_last_chip
;
782 addr
= i2c_mm_last_addr
;
783 alen
= i2c_mm_last_alen
;
785 if ((flag
& CMD_FLAG_REPEAT
) == 0) {
787 * New command specified. Check for a size specification.
788 * Defaults to byte if no or incorrect specification.
790 size
= cmd_get_data_size(argv
[0], 1);
793 * Chip is always specified.
795 chip
= hextoul(argv
[1], NULL
);
798 * Address is always specified.
800 addr
= hextoul(argv
[2], NULL
);
801 alen
= get_alen(argv
[2], DEFAULT_ADDR_LEN
);
803 return CMD_RET_USAGE
;
806 #if CONFIG_IS_ENABLED(DM_I2C)
807 ret
= i2c_get_cur_bus_chip(chip
, &dev
);
808 if (!ret
&& alen
!= -1)
809 ret
= i2c_set_chip_offset_len(dev
, alen
);
811 return i2c_report_err(ret
, I2C_ERR_WRITE
);
815 * Print the address, followed by value. Then accept input for
816 * the next value. A non-converted value exits.
819 printf("%08lx:", addr
);
820 #if CONFIG_IS_ENABLED(DM_I2C)
821 ret
= dm_i2c_read(dev
, addr
, (uchar
*)&data
, size
);
823 ret
= i2c_read(chip
, addr
, alen
, (uchar
*)&data
, size
);
826 return i2c_report_err(ret
, I2C_ERR_READ
);
828 data
= cpu_to_be32(data
);
830 printf(" %02lx", (data
>> 24) & 0x000000FF);
832 printf(" %04lx", (data
>> 16) & 0x0000FFFF);
834 printf(" %08lx", data
);
836 nbytes
= cli_readline(" ? ");
839 * <CR> pressed as only input, don't modify current
840 * location and move to next.
845 /* good enough to not time out */
846 bootretry_reset_cmd_timeout();
848 #ifdef CONFIG_BOOT_RETRY_TIME
849 else if (nbytes
== -2)
850 break; /* timed out, exit the command */
855 data
= hextoul(console_buffer
, &endp
);
860 data
= be32_to_cpu(data
);
861 nbytes
= endp
- console_buffer
;
864 * good enough to not time out
866 bootretry_reset_cmd_timeout();
867 #if CONFIG_IS_ENABLED(DM_I2C)
868 ret
= dm_i2c_write(dev
, addr
, (uchar
*)&data
,
871 ret
= i2c_write(chip
, addr
, alen
,
872 (uchar
*)&data
, size
);
875 return i2c_report_err(ret
,
877 #if CONFIG_SYS_EEPROM_PAGE_WRITE_DELAY_MS > 0
878 udelay(CONFIG_SYS_EEPROM_PAGE_WRITE_DELAY_MS
* 1000);
886 i2c_mm_last_chip
= chip
;
887 i2c_mm_last_addr
= addr
;
888 i2c_mm_last_alen
= alen
;
894 * do_i2c_probe() - Handle the "i2c probe" command-line command
895 * @cmdtp: Command data struct pointer
896 * @flag: Command flag
897 * @argc: Command-line argument count
898 * @argv: Array of command-line arguments
900 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
906 * Returns zero (success) if one or more I2C devices was found
908 static int do_i2c_probe(struct cmd_tbl
*cmdtp
, int flag
, int argc
,
914 #if defined(CFG_SYS_I2C_NOPROBES)
916 unsigned int bus
= GET_BUS_NUM
;
917 #endif /* NOPROBES */
919 #if CONFIG_IS_ENABLED(DM_I2C)
920 struct udevice
*bus
, *dev
;
922 if (i2c_get_cur_bus(&bus
))
923 return CMD_RET_FAILURE
;
927 addr
= simple_strtol(argv
[1], 0, 16);
929 puts ("Valid chip addresses:");
930 for (j
= 0; j
< 128; j
++) {
931 if ((0 <= addr
) && (j
!= addr
))
934 #if defined(CFG_SYS_I2C_NOPROBES)
936 for (k
= 0; k
< ARRAY_SIZE(i2c_no_probes
); k
++) {
937 if (COMPARE_BUS(bus
, k
) && COMPARE_ADDR(j
, k
)) {
945 #if CONFIG_IS_ENABLED(DM_I2C)
946 ret
= dm_i2c_probe(bus
, j
, 0, &dev
);
957 #if defined(CFG_SYS_I2C_NOPROBES)
958 puts ("Excluded chip addresses:");
959 for (k
= 0; k
< ARRAY_SIZE(i2c_no_probes
); k
++) {
960 if (COMPARE_BUS(bus
,k
))
961 printf(" %02X", NO_PROBE_ADDR(k
));
970 * do_i2c_loop() - Handle the "i2c loop" command-line command
971 * @cmdtp: Command data struct pointer
972 * @flag: Command flag
973 * @argc: Command-line argument count
974 * @argv: Array of command-line arguments
976 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
980 * i2c loop {i2c_chip} {addr}{.0, .1, .2} [{length}] [{delay}]
981 * {length} - Number of bytes to read
982 * {delay} - A DECIMAL number and defaults to 1000 uSec
984 static int do_i2c_loop(struct cmd_tbl
*cmdtp
, int flag
, int argc
,
994 #if CONFIG_IS_ENABLED(DM_I2C)
999 return CMD_RET_USAGE
;
1002 * Chip is always specified.
1004 chip
= hextoul(argv
[1], NULL
);
1007 * Address is always specified.
1009 addr
= hextoul(argv
[2], NULL
);
1010 alen
= get_alen(argv
[2], DEFAULT_ADDR_LEN
);
1012 return CMD_RET_USAGE
;
1013 #if CONFIG_IS_ENABLED(DM_I2C)
1014 ret
= i2c_get_cur_bus_chip(chip
, &dev
);
1015 if (!ret
&& alen
!= -1)
1016 ret
= i2c_set_chip_offset_len(dev
, alen
);
1018 return i2c_report_err(ret
, I2C_ERR_WRITE
);
1022 * Length is the number of objects, not number of bytes.
1025 length
= hextoul(argv
[3], NULL
);
1026 if (length
> sizeof(bytes
))
1027 length
= sizeof(bytes
);
1030 * The delay time (uSec) is optional.
1034 delay
= dectoul(argv
[4], NULL
);
1039 #if CONFIG_IS_ENABLED(DM_I2C)
1040 ret
= dm_i2c_read(dev
, addr
, bytes
, length
);
1042 ret
= i2c_read(chip
, addr
, alen
, bytes
, length
);
1045 i2c_report_err(ret
, I2C_ERR_READ
);
1054 * The SDRAM command is separately configured because many
1055 * (most?) embedded boards don't use SDRAM DIMMs.
1057 * FIXME: Document and probably move elsewhere!
1059 #if defined(CONFIG_CMD_SDRAM)
1060 static void print_ddr2_tcyc (u_char
const b
)
1062 printf ("%d.", (b
>> 4) & 0x0F);
1074 printf ("%d ns\n", b
& 0x0F);
1094 static void decode_bits (u_char
const b
, char const *str
[], int const do_once
)
1098 for (mask
= 0x80; mask
!= 0x00; mask
>>= 1, ++str
) {
1109 * i2c sdram {i2c_chip}
1111 static int do_sdram(struct cmd_tbl
*cmdtp
, int flag
, int argc
,
1114 enum { unknown
, EDO
, SDRAM
, DDR
, DDR2
, DDR3
, DDR4
} type
;
1120 #if CONFIG_IS_ENABLED(DM_I2C)
1121 struct udevice
*dev
;
1124 static const char *decode_CAS_DDR2
[] = {
1125 " TBD", " 6", " 5", " 4", " 3", " 2", " TBD", " TBD"
1128 static const char *decode_CAS_default
[] = {
1129 " TBD", " 7", " 6", " 5", " 4", " 3", " 2", " 1"
1132 static const char *decode_CS_WE_default
[] = {
1133 " TBD", " 6", " 5", " 4", " 3", " 2", " 1", " 0"
1136 static const char *decode_byte21_default
[] = {
1138 " Redundant row address\n",
1139 " Differential clock input\n",
1140 " Registerd DQMB inputs\n",
1141 " Buffered DQMB inputs\n",
1143 " Registered address/control lines\n",
1144 " Buffered address/control lines\n"
1147 static const char *decode_byte22_DDR2
[] = {
1153 " Supports partial array self refresh\n",
1154 " Supports 50 ohm ODT\n",
1155 " Supports weak driver\n"
1158 static const char *decode_row_density_DDR2
[] = {
1159 "512 MiB", "256 MiB", "128 MiB", "16 GiB",
1160 "8 GiB", "4 GiB", "2 GiB", "1 GiB"
1163 static const char *decode_row_density_default
[] = {
1164 "512 MiB", "256 MiB", "128 MiB", "64 MiB",
1165 "32 MiB", "16 MiB", "8 MiB", "4 MiB"
1169 return CMD_RET_USAGE
;
1172 * Chip is always specified.
1174 chip
= hextoul(argv
[1], NULL
);
1176 #if CONFIG_IS_ENABLED(DM_I2C)
1177 ret
= i2c_get_cur_bus_chip(chip
, &dev
);
1179 ret
= dm_i2c_read(dev
, 0, data
, sizeof(data
));
1181 ret
= i2c_read(chip
, 0, 1, data
, sizeof(data
));
1184 puts ("No SDRAM Serial Presence Detect found.\n");
1189 for (j
= 0; j
< 63; j
++) {
1192 if (cksum
!= data
[63]) {
1193 printf ("WARNING: Configuration data checksum failure:\n"
1194 " is 0x%02x, calculated 0x%02x\n", data
[63], cksum
);
1196 printf ("SPD data revision %d.%d\n",
1197 (data
[62] >> 4) & 0x0F, data
[62] & 0x0F);
1198 printf ("Bytes used 0x%02X\n", data
[0]);
1199 printf ("Serial memory size 0x%02X\n", 1 << data
[1]);
1201 puts ("Memory type ");
1233 puts ("Row address bits ");
1234 if ((data
[3] & 0x00F0) == 0)
1235 printf ("%d\n", data
[3] & 0x0F);
1237 printf ("%d/%d\n", data
[3] & 0x0F, (data
[3] >> 4) & 0x0F);
1239 puts ("Column address bits ");
1240 if ((data
[4] & 0x00F0) == 0)
1241 printf ("%d\n", data
[4] & 0x0F);
1243 printf ("%d/%d\n", data
[4] & 0x0F, (data
[4] >> 4) & 0x0F);
1247 printf ("Number of ranks %d\n",
1248 (data
[5] & 0x07) + 1);
1251 printf ("Module rows %d\n", data
[5]);
1257 printf ("Module data width %d bits\n", data
[6]);
1260 printf ("Module data width %d bits\n",
1261 (data
[7] << 8) | data
[6]);
1265 puts ("Interface signal levels ");
1267 case 0: puts ("TTL 5.0 V\n"); break;
1268 case 1: puts ("LVTTL\n"); break;
1269 case 2: puts ("HSTL 1.5 V\n"); break;
1270 case 3: puts ("SSTL 3.3 V\n"); break;
1271 case 4: puts ("SSTL 2.5 V\n"); break;
1272 case 5: puts ("SSTL 1.8 V\n"); break;
1273 default: puts ("unknown\n"); break;
1278 printf ("SDRAM cycle time ");
1279 print_ddr2_tcyc (data
[9]);
1282 printf ("SDRAM cycle time %d.%d ns\n",
1283 (data
[9] >> 4) & 0x0F, data
[9] & 0x0F);
1289 printf ("SDRAM access time 0.%d%d ns\n",
1290 (data
[10] >> 4) & 0x0F, data
[10] & 0x0F);
1293 printf ("SDRAM access time %d.%d ns\n",
1294 (data
[10] >> 4) & 0x0F, data
[10] & 0x0F);
1298 puts ("EDC configuration ");
1300 case 0: puts ("None\n"); break;
1301 case 1: puts ("Parity\n"); break;
1302 case 2: puts ("ECC\n"); break;
1303 default: puts ("unknown\n"); break;
1306 if ((data
[12] & 0x80) == 0)
1307 puts ("No self refresh, rate ");
1309 puts ("Self refresh, rate ");
1311 switch(data
[12] & 0x7F) {
1312 case 0: puts ("15.625 us\n"); break;
1313 case 1: puts ("3.9 us\n"); break;
1314 case 2: puts ("7.8 us\n"); break;
1315 case 3: puts ("31.3 us\n"); break;
1316 case 4: puts ("62.5 us\n"); break;
1317 case 5: puts ("125 us\n"); break;
1318 default: puts ("unknown\n"); break;
1323 printf ("SDRAM width (primary) %d\n", data
[13]);
1326 printf ("SDRAM width (primary) %d\n", data
[13] & 0x7F);
1327 if ((data
[13] & 0x80) != 0) {
1328 printf (" (second bank) %d\n",
1329 2 * (data
[13] & 0x7F));
1337 printf ("EDC width %d\n", data
[14]);
1340 if (data
[14] != 0) {
1341 printf ("EDC width %d\n",
1344 if ((data
[14] & 0x80) != 0) {
1345 printf (" (second bank) %d\n",
1346 2 * (data
[14] & 0x7F));
1353 printf ("Min clock delay, back-to-back random column addresses "
1357 puts ("Burst length(s) ");
1358 if (data
[16] & 0x80) puts (" Page");
1359 if (data
[16] & 0x08) puts (" 8");
1360 if (data
[16] & 0x04) puts (" 4");
1361 if (data
[16] & 0x02) puts (" 2");
1362 if (data
[16] & 0x01) puts (" 1");
1364 printf ("Number of banks %d\n", data
[17]);
1368 puts ("CAS latency(s) ");
1369 decode_bits (data
[18], decode_CAS_DDR2
, 0);
1373 puts ("CAS latency(s) ");
1374 decode_bits (data
[18], decode_CAS_default
, 0);
1380 puts ("CS latency(s) ");
1381 decode_bits (data
[19], decode_CS_WE_default
, 0);
1386 puts ("WE latency(s) ");
1387 decode_bits (data
[20], decode_CS_WE_default
, 0);
1393 puts ("Module attributes:\n");
1394 if (data
[21] & 0x80)
1395 puts (" TBD (bit 7)\n");
1396 if (data
[21] & 0x40)
1397 puts (" Analysis probe installed\n");
1398 if (data
[21] & 0x20)
1399 puts (" TBD (bit 5)\n");
1400 if (data
[21] & 0x10)
1401 puts (" FET switch external enable\n");
1402 printf (" %d PLLs on DIMM\n", (data
[21] >> 2) & 0x03);
1403 if (data
[20] & 0x11) {
1404 printf (" %d active registers on DIMM\n",
1405 (data
[21] & 0x03) + 1);
1409 puts ("Module attributes:\n");
1413 decode_bits (data
[21], decode_byte21_default
, 0);
1419 decode_bits (data
[22], decode_byte22_DDR2
, 0);
1422 puts ("Device attributes:\n");
1423 if (data
[22] & 0x80) puts (" TBD (bit 7)\n");
1424 if (data
[22] & 0x40) puts (" TBD (bit 6)\n");
1425 if (data
[22] & 0x20) puts (" Upper Vcc tolerance 5%\n");
1426 else puts (" Upper Vcc tolerance 10%\n");
1427 if (data
[22] & 0x10) puts (" Lower Vcc tolerance 5%\n");
1428 else puts (" Lower Vcc tolerance 10%\n");
1429 if (data
[22] & 0x08) puts (" Supports write1/read burst\n");
1430 if (data
[22] & 0x04) puts (" Supports precharge all\n");
1431 if (data
[22] & 0x02) puts (" Supports auto precharge\n");
1432 if (data
[22] & 0x01) puts (" Supports early RAS# precharge\n");
1438 printf ("SDRAM cycle time (2nd highest CAS latency) ");
1439 print_ddr2_tcyc (data
[23]);
1442 printf ("SDRAM cycle time (2nd highest CAS latency) %d."
1443 "%d ns\n", (data
[23] >> 4) & 0x0F, data
[23] & 0x0F);
1449 printf ("SDRAM access from clock (2nd highest CAS latency) 0."
1450 "%d%d ns\n", (data
[24] >> 4) & 0x0F, data
[24] & 0x0F);
1453 printf ("SDRAM access from clock (2nd highest CAS latency) %d."
1454 "%d ns\n", (data
[24] >> 4) & 0x0F, data
[24] & 0x0F);
1460 printf ("SDRAM cycle time (3rd highest CAS latency) ");
1461 print_ddr2_tcyc (data
[25]);
1464 printf ("SDRAM cycle time (3rd highest CAS latency) %d."
1465 "%d ns\n", (data
[25] >> 4) & 0x0F, data
[25] & 0x0F);
1471 printf ("SDRAM access from clock (3rd highest CAS latency) 0."
1472 "%d%d ns\n", (data
[26] >> 4) & 0x0F, data
[26] & 0x0F);
1475 printf ("SDRAM access from clock (3rd highest CAS latency) %d."
1476 "%d ns\n", (data
[26] >> 4) & 0x0F, data
[26] & 0x0F);
1482 printf ("Minimum row precharge %d.%02d ns\n",
1483 (data
[27] >> 2) & 0x3F, 25 * (data
[27] & 0x03));
1486 printf ("Minimum row precharge %d ns\n", data
[27]);
1492 printf ("Row active to row active min %d.%02d ns\n",
1493 (data
[28] >> 2) & 0x3F, 25 * (data
[28] & 0x03));
1496 printf ("Row active to row active min %d ns\n", data
[28]);
1502 printf ("RAS to CAS delay min %d.%02d ns\n",
1503 (data
[29] >> 2) & 0x3F, 25 * (data
[29] & 0x03));
1506 printf ("RAS to CAS delay min %d ns\n", data
[29]);
1510 printf ("Minimum RAS pulse width %d ns\n", data
[30]);
1514 puts ("Density of each row ");
1515 decode_bits (data
[31], decode_row_density_DDR2
, 1);
1519 puts ("Density of each row ");
1520 decode_bits (data
[31], decode_row_density_default
, 1);
1527 puts ("Command and Address setup ");
1528 if (data
[32] >= 0xA0) {
1529 printf ("1.%d%d ns\n",
1530 ((data
[32] >> 4) & 0x0F) - 10, data
[32] & 0x0F);
1532 printf ("0.%d%d ns\n",
1533 ((data
[32] >> 4) & 0x0F), data
[32] & 0x0F);
1537 printf ("Command and Address setup %c%d.%d ns\n",
1538 (data
[32] & 0x80) ? '-' : '+',
1539 (data
[32] >> 4) & 0x07, data
[32] & 0x0F);
1545 puts ("Command and Address hold ");
1546 if (data
[33] >= 0xA0) {
1547 printf ("1.%d%d ns\n",
1548 ((data
[33] >> 4) & 0x0F) - 10, data
[33] & 0x0F);
1550 printf ("0.%d%d ns\n",
1551 ((data
[33] >> 4) & 0x0F), data
[33] & 0x0F);
1555 printf ("Command and Address hold %c%d.%d ns\n",
1556 (data
[33] & 0x80) ? '-' : '+',
1557 (data
[33] >> 4) & 0x07, data
[33] & 0x0F);
1563 printf ("Data signal input setup 0.%d%d ns\n",
1564 (data
[34] >> 4) & 0x0F, data
[34] & 0x0F);
1567 printf ("Data signal input setup %c%d.%d ns\n",
1568 (data
[34] & 0x80) ? '-' : '+',
1569 (data
[34] >> 4) & 0x07, data
[34] & 0x0F);
1575 printf ("Data signal input hold 0.%d%d ns\n",
1576 (data
[35] >> 4) & 0x0F, data
[35] & 0x0F);
1579 printf ("Data signal input hold %c%d.%d ns\n",
1580 (data
[35] & 0x80) ? '-' : '+',
1581 (data
[35] >> 4) & 0x07, data
[35] & 0x0F);
1585 puts ("Manufacturer's JEDEC ID ");
1586 for (j
= 64; j
<= 71; j
++)
1587 printf ("%02X ", data
[j
]);
1589 printf ("Manufacturing Location %02X\n", data
[72]);
1590 puts ("Manufacturer's Part Number ");
1591 for (j
= 73; j
<= 90; j
++)
1592 printf ("%02X ", data
[j
]);
1594 printf ("Revision Code %02X %02X\n", data
[91], data
[92]);
1595 printf ("Manufacturing Date %02X %02X\n", data
[93], data
[94]);
1596 puts ("Assembly Serial Number ");
1597 for (j
= 95; j
<= 98; j
++)
1598 printf ("%02X ", data
[j
]);
1602 printf ("Speed rating PC%d\n",
1603 data
[126] == 0x66 ? 66 : data
[126]);
1611 * i2c edid {i2c_chip}
1613 #if defined(CONFIG_I2C_EDID)
1614 int do_edid(struct cmd_tbl
*cmdtp
, int flag
, int argc
, char *const argv
[])
1617 struct edid1_info edid
;
1619 #if CONFIG_IS_ENABLED(DM_I2C)
1620 struct udevice
*dev
;
1628 chip
= hextoul(argv
[1], NULL
);
1629 #if CONFIG_IS_ENABLED(DM_I2C)
1630 ret
= i2c_get_cur_bus_chip(chip
, &dev
);
1632 ret
= dm_i2c_read(dev
, 0, (uchar
*)&edid
, sizeof(edid
));
1634 ret
= i2c_read(chip
, 0, 1, (uchar
*)&edid
, sizeof(edid
));
1637 return i2c_report_err(ret
, I2C_ERR_READ
);
1639 if (edid_check_info(&edid
)) {
1640 puts("Content isn't valid EDID.\n");
1644 edid_print_info(&edid
);
1648 #endif /* CONFIG_I2C_EDID */
1650 #if CONFIG_IS_ENABLED(DM_I2C)
1651 static void show_bus(struct udevice
*bus
)
1653 struct udevice
*dev
;
1655 printf("Bus %d:\t%s", dev_seq(bus
), bus
->name
);
1656 if (device_active(bus
))
1657 printf(" (active %d)", dev_seq(bus
));
1659 for (device_find_first_child(bus
, &dev
);
1661 device_find_next_child(&dev
)) {
1662 struct dm_i2c_chip
*chip
= dev_get_parent_plat(dev
);
1664 printf(" %02x: %s, offset len %x, flags %x\n",
1665 chip
->chip_addr
, dev
->name
, chip
->offset_len
,
1672 * do_i2c_show_bus() - Handle the "i2c bus" command-line command
1673 * @cmdtp: Command data struct pointer
1674 * @flag: Command flag
1675 * @argc: Command-line argument count
1676 * @argv: Array of command-line arguments
1678 * Returns zero always.
1680 #if CONFIG_IS_ENABLED(SYS_I2C_LEGACY) || CONFIG_IS_ENABLED(DM_I2C)
1681 static int do_i2c_show_bus(struct cmd_tbl
*cmdtp
, int flag
, int argc
,
1685 /* show all busses */
1686 #if CONFIG_IS_ENABLED(DM_I2C)
1687 struct udevice
*bus
;
1691 ret
= uclass_get(UCLASS_I2C
, &uc
);
1693 return CMD_RET_FAILURE
;
1694 uclass_foreach_dev(bus
, uc
)
1699 for (i
= 0; i
< CFG_SYS_NUM_I2C_BUSES
; i
++) {
1700 printf("Bus %d:\t%s", i
, I2C_ADAP_NR(i
)->name
);
1701 #ifndef CFG_SYS_I2C_DIRECT_BUS
1704 for (j
= 0; j
< CFG_SYS_I2C_MAX_HOPS
; j
++) {
1705 if (i2c_bus
[i
].next_hop
[j
].chip
== 0)
1707 printf("->%s@0x%2x:%d",
1708 i2c_bus
[i
].next_hop
[j
].mux
.name
,
1709 i2c_bus
[i
].next_hop
[j
].chip
,
1710 i2c_bus
[i
].next_hop
[j
].channel
);
1719 /* show specific bus */
1720 i
= dectoul(argv
[1], NULL
);
1721 #if CONFIG_IS_ENABLED(DM_I2C)
1722 struct udevice
*bus
;
1725 ret
= uclass_get_device_by_seq(UCLASS_I2C
, i
, &bus
);
1727 printf("Invalid bus %d: err=%d\n", i
, ret
);
1728 return CMD_RET_FAILURE
;
1732 if (i
>= CFG_SYS_NUM_I2C_BUSES
) {
1733 printf("Invalid bus %d\n", i
);
1736 printf("Bus %d:\t%s", i
, I2C_ADAP_NR(i
)->name
);
1737 #ifndef CFG_SYS_I2C_DIRECT_BUS
1739 for (j
= 0; j
< CFG_SYS_I2C_MAX_HOPS
; j
++) {
1740 if (i2c_bus
[i
].next_hop
[j
].chip
== 0)
1742 printf("->%s@0x%2x:%d",
1743 i2c_bus
[i
].next_hop
[j
].mux
.name
,
1744 i2c_bus
[i
].next_hop
[j
].chip
,
1745 i2c_bus
[i
].next_hop
[j
].channel
);
1757 * do_i2c_bus_num() - Handle the "i2c dev" command-line command
1758 * @cmdtp: Command data struct pointer
1759 * @flag: Command flag
1760 * @argc: Command-line argument count
1761 * @argv: Array of command-line arguments
1763 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1766 #if CONFIG_IS_ENABLED(SYS_I2C_LEGACY) || CONFIG_IS_ENABLED(DM_I2C)
1767 static int do_i2c_bus_num(struct cmd_tbl
*cmdtp
, int flag
, int argc
,
1774 /* querying current setting */
1775 #if CONFIG_IS_ENABLED(DM_I2C)
1776 struct udevice
*bus
;
1778 if (!i2c_get_cur_bus(&bus
))
1779 bus_no
= dev_seq(bus
);
1783 bus_no
= i2c_get_bus_num();
1785 printf("Current bus is %d\n", bus_no
);
1787 bus_no
= dectoul(argv
[1], NULL
);
1788 #if CONFIG_IS_ENABLED(SYS_I2C_LEGACY)
1789 if (bus_no
>= CFG_SYS_NUM_I2C_BUSES
) {
1790 printf("Invalid bus %d\n", bus_no
);
1794 printf("Setting bus to %d\n", bus_no
);
1795 #if CONFIG_IS_ENABLED(DM_I2C)
1796 ret
= cmd_i2c_set_bus_num(bus_no
);
1798 ret
= i2c_set_bus_num(bus_no
);
1801 printf("Failure changing bus number (%d)\n", ret
);
1804 return ret
? CMD_RET_FAILURE
: 0;
1806 #endif /* CONFIG_IS_ENABLED(SYS_I2C_LEGACY) */
1809 * do_i2c_bus_speed() - Handle the "i2c speed" command-line command
1810 * @cmdtp: Command data struct pointer
1811 * @flag: Command flag
1812 * @argc: Command-line argument count
1813 * @argv: Array of command-line arguments
1815 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1818 static int do_i2c_bus_speed(struct cmd_tbl
*cmdtp
, int flag
, int argc
,
1823 #if CONFIG_IS_ENABLED(DM_I2C)
1824 struct udevice
*bus
;
1826 if (i2c_get_cur_bus(&bus
))
1830 #if CONFIG_IS_ENABLED(DM_I2C)
1831 speed
= dm_i2c_get_bus_speed(bus
);
1833 speed
= i2c_get_bus_speed();
1835 /* querying current speed */
1836 printf("Current bus speed=%d\n", speed
);
1838 speed
= dectoul(argv
[1], NULL
);
1839 printf("Setting bus speed to %d Hz\n", speed
);
1840 #if CONFIG_IS_ENABLED(DM_I2C)
1841 ret
= dm_i2c_set_bus_speed(bus
, speed
);
1843 ret
= i2c_set_bus_speed(speed
);
1846 printf("Failure changing bus speed (%d)\n", ret
);
1849 return ret
? CMD_RET_FAILURE
: 0;
1853 * do_i2c_mm() - Handle the "i2c mm" command-line command
1854 * @cmdtp: Command data struct pointer
1855 * @flag: Command flag
1856 * @argc: Command-line argument count
1857 * @argv: Array of command-line arguments
1859 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1862 static int do_i2c_mm(struct cmd_tbl
*cmdtp
, int flag
, int argc
,
1865 return mod_i2c_mem (cmdtp
, 1, flag
, argc
, argv
);
1869 * do_i2c_nm() - Handle the "i2c nm" command-line command
1870 * @cmdtp: Command data struct pointer
1871 * @flag: Command flag
1872 * @argc: Command-line argument count
1873 * @argv: Array of command-line arguments
1875 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1878 static int do_i2c_nm(struct cmd_tbl
*cmdtp
, int flag
, int argc
,
1881 return mod_i2c_mem (cmdtp
, 0, flag
, argc
, argv
);
1885 * do_i2c_reset() - Handle the "i2c reset" command-line command
1886 * @cmdtp: Command data struct pointer
1887 * @flag: Command flag
1888 * @argc: Command-line argument count
1889 * @argv: Array of command-line arguments
1891 * Returns zero always.
1893 static int do_i2c_reset(struct cmd_tbl
*cmdtp
, int flag
, int argc
,
1896 #if CONFIG_IS_ENABLED(DM_I2C)
1897 struct udevice
*bus
;
1899 if (i2c_get_cur_bus(&bus
))
1900 return CMD_RET_FAILURE
;
1901 if (i2c_deblock(bus
)) {
1902 printf("Error: Not supported by the driver\n");
1903 return CMD_RET_FAILURE
;
1905 #elif CONFIG_IS_ENABLED(SYS_I2C_LEGACY)
1906 i2c_init(I2C_ADAP
->speed
, I2C_ADAP
->slaveaddr
);
1911 static struct cmd_tbl cmd_i2c_sub
[] = {
1912 #if CONFIG_IS_ENABLED(SYS_I2C_LEGACY) || CONFIG_IS_ENABLED(DM_I2C)
1913 U_BOOT_CMD_MKENT(bus
, 1, 1, do_i2c_show_bus
, "", ""),
1915 U_BOOT_CMD_MKENT(crc32
, 3, 1, do_i2c_crc
, "", ""),
1916 #if CONFIG_IS_ENABLED(SYS_I2C_LEGACY) || CONFIG_IS_ENABLED(DM_I2C)
1917 U_BOOT_CMD_MKENT(dev
, 1, 1, do_i2c_bus_num
, "", ""),
1919 #if defined(CONFIG_I2C_EDID)
1920 U_BOOT_CMD_MKENT(edid
, 1, 1, do_edid
, "", ""),
1921 #endif /* CONFIG_I2C_EDID */
1922 U_BOOT_CMD_MKENT(loop
, 3, 1, do_i2c_loop
, "", ""),
1923 U_BOOT_CMD_MKENT(md
, 3, 1, do_i2c_md
, "", ""),
1924 U_BOOT_CMD_MKENT(mm
, 2, 1, do_i2c_mm
, "", ""),
1925 U_BOOT_CMD_MKENT(mw
, 3, 1, do_i2c_mw
, "", ""),
1926 U_BOOT_CMD_MKENT(nm
, 2, 1, do_i2c_nm
, "", ""),
1927 U_BOOT_CMD_MKENT(probe
, 0, 1, do_i2c_probe
, "", ""),
1928 U_BOOT_CMD_MKENT(read
, 5, 1, do_i2c_read
, "", ""),
1929 U_BOOT_CMD_MKENT(write
, 6, 0, do_i2c_write
, "", ""),
1930 #if CONFIG_IS_ENABLED(DM_I2C)
1931 U_BOOT_CMD_MKENT(flags
, 2, 1, do_i2c_flags
, "", ""),
1932 U_BOOT_CMD_MKENT(olen
, 2, 1, do_i2c_olen
, "", ""),
1934 U_BOOT_CMD_MKENT(reset
, 0, 1, do_i2c_reset
, "", ""),
1935 #if defined(CONFIG_CMD_SDRAM)
1936 U_BOOT_CMD_MKENT(sdram
, 1, 1, do_sdram
, "", ""),
1938 U_BOOT_CMD_MKENT(speed
, 1, 1, do_i2c_bus_speed
, "", ""),
1942 * do_i2c() - Handle the "i2c" command-line command
1943 * @cmdtp: Command data struct pointer
1944 * @flag: Command flag
1945 * @argc: Command-line argument count
1946 * @argv: Array of command-line arguments
1948 * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1951 static int do_i2c(struct cmd_tbl
*cmdtp
, int flag
, int argc
, char *const argv
[])
1956 return CMD_RET_USAGE
;
1958 /* Strip off leading 'i2c' command argument */
1962 c
= find_cmd_tbl(argv
[0], &cmd_i2c_sub
[0], ARRAY_SIZE(cmd_i2c_sub
));
1965 return c
->cmd(cmdtp
, flag
, argc
, argv
);
1967 return CMD_RET_USAGE
;
1970 /***************************************************/
1971 U_BOOT_LONGHELP(i2c
,
1972 #if CONFIG_IS_ENABLED(SYS_I2C_LEGACY) || CONFIG_IS_ENABLED(DM_I2C)
1973 "bus [muxtype:muxaddr:muxchannel] - show I2C bus info\n"
1974 "i2c " /* That's the prefix for the crc32 command below. */
1976 "crc32 chip address[.0, .1, .2] count - compute CRC32 checksum\n"
1977 #if CONFIG_IS_ENABLED(SYS_I2C_LEGACY) || CONFIG_IS_ENABLED(DM_I2C)
1978 "i2c dev [dev] - show or set current I2C bus\n"
1980 #if defined(CONFIG_I2C_EDID)
1981 "i2c edid chip - print EDID configuration information\n"
1982 #endif /* CONFIG_I2C_EDID */
1983 "i2c loop chip address[.0, .1, .2] [# of objects] - looping read of device\n"
1984 "i2c md chip address[.0, .1, .2] [# of objects] - read from I2C device\n"
1985 "i2c mm chip address[.0, .1, .2] - write to I2C device (auto-incrementing)\n"
1986 "i2c mw chip address[.0, .1, .2] value [count] - write to I2C device (fill)\n"
1987 "i2c nm chip address[.0, .1, .2] - write to I2C device (constant address)\n"
1988 "i2c probe [address] - test for and show device(s) on the I2C bus\n"
1989 "i2c read chip address[.0, .1, .2] length memaddress - read to memory\n"
1990 "i2c write memaddress chip address[.0, .1, .2] length [-s] - write memory\n"
1991 " to I2C; the -s option selects bulk write in a single transaction\n"
1992 #if CONFIG_IS_ENABLED(DM_I2C)
1993 "i2c flags chip [flags] - set or get chip flags\n"
1994 "i2c olen chip [offset_length] - set or get chip offset length\n"
1996 "i2c reset - re-init the I2C Controller\n"
1997 #if defined(CONFIG_CMD_SDRAM)
1998 "i2c sdram chip - print SDRAM configuration information\n"
2000 "i2c speed [speed] - show or set I2C bus speed");