]> Gitweb @ Texas Instruments - Open Source Git Repositories - git.TI.com/gitweb - glsdk/glsdk-u-boot.git/blob - common/cmd_i2c.c
Merge branch 'u-boot-imx/master' into 'u-boot-arm/master'
[glsdk/glsdk-u-boot.git] / common / cmd_i2c.c
1 /*
2  * (C) Copyright 2001
3  * Gerald Van Baren, Custom IDEAS, vanbaren@cideas.com.
4  *
5  * See file CREDITS for list of people who contributed to this
6  * project.
7  *
8  * This program is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU General Public License as
10  * published by the Free Software Foundation; either version 2 of
11  * the License, or (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License
19  * along with this program; if not, write to the Free Software
20  * Foundation, Inc., 59 Temple Place, Suite 330, Boston,
21  * MA 02111-1307 USA
22  */
24 /*
25  * I2C Functions similar to the standard memory functions.
26  *
27  * There are several parameters in many of the commands that bear further
28  * explanations:
29  *
30  * {i2c_chip} is the I2C chip address (the first byte sent on the bus).
31  *   Each I2C chip on the bus has a unique address.  On the I2C data bus,
32  *   the address is the upper seven bits and the LSB is the "read/write"
33  *   bit.  Note that the {i2c_chip} address specified on the command
34  *   line is not shifted up: e.g. a typical EEPROM memory chip may have
35  *   an I2C address of 0x50, but the data put on the bus will be 0xA0
36  *   for write and 0xA1 for read.  This "non shifted" address notation
37  *   matches at least half of the data sheets :-/.
38  *
39  * {addr} is the address (or offset) within the chip.  Small memory
40  *   chips have 8 bit addresses.  Large memory chips have 16 bit
41  *   addresses.  Other memory chips have 9, 10, or 11 bit addresses.
42  *   Many non-memory chips have multiple registers and {addr} is used
43  *   as the register index.  Some non-memory chips have only one register
44  *   and therefore don't need any {addr} parameter.
45  *
46  *   The default {addr} parameter is one byte (.1) which works well for
47  *   memories and registers with 8 bits of address space.
48  *
49  *   You can specify the length of the {addr} field with the optional .0,
50  *   .1, or .2 modifier (similar to the .b, .w, .l modifier).  If you are
51  *   manipulating a single register device which doesn't use an address
52  *   field, use "0.0" for the address and the ".0" length field will
53  *   suppress the address in the I2C data stream.  This also works for
54  *   successive reads using the I2C auto-incrementing memory pointer.
55  *
56  *   If you are manipulating a large memory with 2-byte addresses, use
57  *   the .2 address modifier, e.g. 210.2 addresses location 528 (decimal).
58  *
59  *   Then there are the unfortunate memory chips that spill the most
60  *   significant 1, 2, or 3 bits of address into the chip address byte.
61  *   This effectively makes one chip (logically) look like 2, 4, or
62  *   8 chips.  This is handled (awkwardly) by #defining
63  *   CONFIG_SYS_I2C_EEPROM_ADDR_OVERFLOW and using the .1 modifier on the
64  *   {addr} field (since .1 is the default, it doesn't actually have to
65  *   be specified).  Examples: given a memory chip at I2C chip address
66  *   0x50, the following would happen...
67  *     i2c md 50 0 10   display 16 bytes starting at 0x000
68  *                      On the bus: <S> A0 00 <E> <S> A1 <rd> ... <rd>
69  *     i2c md 50 100 10 display 16 bytes starting at 0x100
70  *                      On the bus: <S> A2 00 <E> <S> A3 <rd> ... <rd>
71  *     i2c md 50 210 10 display 16 bytes starting at 0x210
72  *                      On the bus: <S> A4 10 <E> <S> A5 <rd> ... <rd>
73  *   This is awfully ugly.  It would be nice if someone would think up
74  *   a better way of handling this.
75  *
76  * Adapted from cmd_mem.c which is copyright Wolfgang Denk (wd@denx.de).
77  */
79 #include <common.h>
80 #include <command.h>
81 #include <edid.h>
82 #include <environment.h>
83 #include <i2c.h>
84 #include <malloc.h>
85 #include <asm/byteorder.h>
86 #include <linux/compiler.h>
88 /* Display values from last command.
89  * Memory modify remembered values are different from display memory.
90  */
91 static uchar    i2c_dp_last_chip;
92 static uint     i2c_dp_last_addr;
93 static uint     i2c_dp_last_alen;
94 static uint     i2c_dp_last_length = 0x10;
96 static uchar    i2c_mm_last_chip;
97 static uint     i2c_mm_last_addr;
98 static uint     i2c_mm_last_alen;
100 /* If only one I2C bus is present, the list of devices to ignore when
101  * the probe command is issued is represented by a 1D array of addresses.
102  * When multiple buses are present, the list is an array of bus-address
103  * pairs.  The following macros take care of this */
105 #if defined(CONFIG_SYS_I2C_NOPROBES)
106 #if defined(CONFIG_I2C_MULTI_BUS)
107 static struct
109         uchar   bus;
110         uchar   addr;
111 } i2c_no_probes[] = CONFIG_SYS_I2C_NOPROBES;
112 #define GET_BUS_NUM     i2c_get_bus_num()
113 #define COMPARE_BUS(b,i)        (i2c_no_probes[(i)].bus == (b))
114 #define COMPARE_ADDR(a,i)       (i2c_no_probes[(i)].addr == (a))
115 #define NO_PROBE_ADDR(i)        i2c_no_probes[(i)].addr
116 #else           /* single bus */
117 static uchar i2c_no_probes[] = CONFIG_SYS_I2C_NOPROBES;
118 #define GET_BUS_NUM     0
119 #define COMPARE_BUS(b,i)        ((b) == 0)      /* Make compiler happy */
120 #define COMPARE_ADDR(a,i)       (i2c_no_probes[(i)] == (a))
121 #define NO_PROBE_ADDR(i)        i2c_no_probes[(i)]
122 #endif  /* CONFIG_MULTI_BUS */
124 #define NUM_ELEMENTS_NOPROBE (sizeof(i2c_no_probes)/sizeof(i2c_no_probes[0]))
125 #endif
127 #if defined(CONFIG_I2C_MUX)
128 static I2C_MUX_DEVICE   *i2c_mux_devices = NULL;
129 static  int     i2c_mux_busid = CONFIG_SYS_MAX_I2C_BUS;
131 DECLARE_GLOBAL_DATA_PTR;
133 #endif
135 #define DISP_LINE_LEN   16
137 /**
138  * i2c_init_board() - Board-specific I2C bus init
139  *
140  * This function is the default no-op implementation of I2C bus
141  * initialization. This function can be overriden by board-specific
142  * implementation if needed.
143  */
144 __weak
145 void i2c_init_board(void)
147         return;
150 /* TODO: Implement architecture-specific get/set functions */
152 /**
153  * i2c_get_bus_speed() - Return I2C bus speed
154  *
155  * This function is the default implementation of function for retrieveing
156  * the current I2C bus speed in Hz.
157  *
158  * A driver implementing runtime switching of I2C bus speed must override
159  * this function to report the speed correctly. Simple or legacy drivers
160  * can use this fallback.
161  *
162  * Returns I2C bus speed in Hz.
163  */
164 __weak
165 unsigned int i2c_get_bus_speed(void)
167         return CONFIG_SYS_I2C_SPEED;
170 /**
171  * i2c_set_bus_speed() - Configure I2C bus speed
172  * @speed:      Newly set speed of the I2C bus in Hz
173  *
174  * This function is the default implementation of function for setting
175  * the I2C bus speed in Hz.
176  *
177  * A driver implementing runtime switching of I2C bus speed must override
178  * this function to report the speed correctly. Simple or legacy drivers
179  * can use this fallback.
180  *
181  * Returns zero on success, negative value on error.
182  */
183 __weak
184 int i2c_set_bus_speed(unsigned int speed)
186         if (speed != CONFIG_SYS_I2C_SPEED)
187                 return -1;
189         return 0;
192 /**
193  * get_alen() - Small parser helper function to get address length
194  *
195  * Returns the address length.
196  */
197 static uint get_alen(char *arg)
199         int     j;
200         int     alen;
202         alen = 1;
203         for (j = 0; j < 8; j++) {
204                 if (arg[j] == '.') {
205                         alen = arg[j+1] - '0';
206                         break;
207                 } else if (arg[j] == '\0')
208                         break;
209         }
210         return alen;
213 /**
214  * do_i2c_read() - Handle the "i2c read" command-line command
215  * @cmdtp:      Command data struct pointer
216  * @flag:       Command flag
217  * @argc:       Command-line argument count
218  * @argv:       Array of command-line arguments
219  *
220  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
221  * on error.
222  *
223  * Syntax:
224  *      i2c read {i2c_chip} {devaddr}{.0, .1, .2} {len} {memaddr}
225  */
226 static int do_i2c_read ( cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
228         u_char  chip;
229         uint    devaddr, alen, length;
230         u_char  *memaddr;
232         if (argc != 5)
233                 return CMD_RET_USAGE;
235         /*
236          * I2C chip address
237          */
238         chip = simple_strtoul(argv[1], NULL, 16);
240         /*
241          * I2C data address within the chip.  This can be 1 or
242          * 2 bytes long.  Some day it might be 3 bytes long :-).
243          */
244         devaddr = simple_strtoul(argv[2], NULL, 16);
245         alen = get_alen(argv[2]);
246         if (alen > 3)
247                 return CMD_RET_USAGE;
249         /*
250          * Length is the number of objects, not number of bytes.
251          */
252         length = simple_strtoul(argv[3], NULL, 16);
254         /*
255          * memaddr is the address where to store things in memory
256          */
257         memaddr = (u_char *)simple_strtoul(argv[4], NULL, 16);
259         if (i2c_read(chip, devaddr, alen, memaddr, length) != 0) {
260                 puts ("Error reading the chip.\n");
261                 return 1;
262         }
263         return 0;
266 static int do_i2c_write(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
268         u_char  chip;
269         uint    devaddr, alen, length;
270         u_char  *memaddr;
272         if (argc != 5)
273                 return cmd_usage(cmdtp);
275         /*
276          * memaddr is the address where to store things in memory
277          */
278         memaddr = (u_char *)simple_strtoul(argv[1], NULL, 16);
280         /*
281          * I2C chip address
282          */
283         chip = simple_strtoul(argv[2], NULL, 16);
285         /*
286          * I2C data address within the chip.  This can be 1 or
287          * 2 bytes long.  Some day it might be 3 bytes long :-).
288          */
289         devaddr = simple_strtoul(argv[3], NULL, 16);
290         alen = get_alen(argv[3]);
291         if (alen > 3)
292                 return cmd_usage(cmdtp);
294         /*
295          * Length is the number of objects, not number of bytes.
296          */
297         length = simple_strtoul(argv[4], NULL, 16);
299         while (length-- > 0) {
300                 if (i2c_write(chip, devaddr++, alen, memaddr++, 1) != 0) {
301                         puts("Error writing to the chip.\n");
302                         return 1;
303                 }
304 /*
305  * No write delay with FRAM devices.
306  */
307 #if !defined(CONFIG_SYS_I2C_FRAM)
308                 udelay(11000);
309 #endif
310         }
311         return 0;
314 /**
315  * do_i2c_md() - Handle the "i2c md" command-line command
316  * @cmdtp:      Command data struct pointer
317  * @flag:       Command flag
318  * @argc:       Command-line argument count
319  * @argv:       Array of command-line arguments
320  *
321  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
322  * on error.
323  *
324  * Syntax:
325  *      i2c md {i2c_chip} {addr}{.0, .1, .2} {len}
326  */
327 static int do_i2c_md ( cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
329         u_char  chip;
330         uint    addr, alen, length;
331         int     j, nbytes, linebytes;
333         /* We use the last specified parameters, unless new ones are
334          * entered.
335          */
336         chip   = i2c_dp_last_chip;
337         addr   = i2c_dp_last_addr;
338         alen   = i2c_dp_last_alen;
339         length = i2c_dp_last_length;
341         if (argc < 3)
342                 return CMD_RET_USAGE;
344         if ((flag & CMD_FLAG_REPEAT) == 0) {
345                 /*
346                  * New command specified.
347                  */
349                 /*
350                  * I2C chip address
351                  */
352                 chip = simple_strtoul(argv[1], NULL, 16);
354                 /*
355                  * I2C data address within the chip.  This can be 1 or
356                  * 2 bytes long.  Some day it might be 3 bytes long :-).
357                  */
358                 addr = simple_strtoul(argv[2], NULL, 16);
359                 alen = get_alen(argv[2]);
360                 if (alen > 3)
361                         return CMD_RET_USAGE;
363                 /*
364                  * If another parameter, it is the length to display.
365                  * Length is the number of objects, not number of bytes.
366                  */
367                 if (argc > 3)
368                         length = simple_strtoul(argv[3], NULL, 16);
369         }
371         /*
372          * Print the lines.
373          *
374          * We buffer all read data, so we can make sure data is read only
375          * once.
376          */
377         nbytes = length;
378         do {
379                 unsigned char   linebuf[DISP_LINE_LEN];
380                 unsigned char   *cp;
382                 linebytes = (nbytes > DISP_LINE_LEN) ? DISP_LINE_LEN : nbytes;
384                 if (i2c_read(chip, addr, alen, linebuf, linebytes) != 0)
385                         puts ("Error reading the chip.\n");
386                 else {
387                         printf("%04x:", addr);
388                         cp = linebuf;
389                         for (j=0; j<linebytes; j++) {
390                                 printf(" %02x", *cp++);
391                                 addr++;
392                         }
393                         puts ("    ");
394                         cp = linebuf;
395                         for (j=0; j<linebytes; j++) {
396                                 if ((*cp < 0x20) || (*cp > 0x7e))
397                                         puts (".");
398                                 else
399                                         printf("%c", *cp);
400                                 cp++;
401                         }
402                         putc ('\n');
403                 }
404                 nbytes -= linebytes;
405         } while (nbytes > 0);
407         i2c_dp_last_chip   = chip;
408         i2c_dp_last_addr   = addr;
409         i2c_dp_last_alen   = alen;
410         i2c_dp_last_length = length;
412         return 0;
415 /**
416  * do_i2c_mw() - Handle the "i2c mw" command-line command
417  * @cmdtp:      Command data struct pointer
418  * @flag:       Command flag
419  * @argc:       Command-line argument count
420  * @argv:       Array of command-line arguments
421  *
422  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
423  * on error.
424  *
425  * Syntax:
426  *      i2c mw {i2c_chip} {addr}{.0, .1, .2} {data} [{count}]
427  */
428 static int do_i2c_mw ( cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
430         uchar   chip;
431         ulong   addr;
432         uint    alen;
433         uchar   byte;
434         int     count;
436         if ((argc < 4) || (argc > 5))
437                 return CMD_RET_USAGE;
439         /*
440          * Chip is always specified.
441          */
442         chip = simple_strtoul(argv[1], NULL, 16);
444         /*
445          * Address is always specified.
446          */
447         addr = simple_strtoul(argv[2], NULL, 16);
448         alen = get_alen(argv[2]);
449         if (alen > 3)
450                 return CMD_RET_USAGE;
452         /*
453          * Value to write is always specified.
454          */
455         byte = simple_strtoul(argv[3], NULL, 16);
457         /*
458          * Optional count
459          */
460         if (argc == 5)
461                 count = simple_strtoul(argv[4], NULL, 16);
462         else
463                 count = 1;
465         while (count-- > 0) {
466                 if (i2c_write(chip, addr++, alen, &byte, 1) != 0)
467                         puts ("Error writing the chip.\n");
468                 /*
469                  * Wait for the write to complete.  The write can take
470                  * up to 10mSec (we allow a little more time).
471                  */
472 /*
473  * No write delay with FRAM devices.
474  */
475 #if !defined(CONFIG_SYS_I2C_FRAM)
476                 udelay(11000);
477 #endif
478         }
480         return 0;
483 /**
484  * do_i2c_crc() - Handle the "i2c crc32" command-line command
485  * @cmdtp:      Command data struct pointer
486  * @flag:       Command flag
487  * @argc:       Command-line argument count
488  * @argv:       Array of command-line arguments
489  *
490  * Calculate a CRC on memory
491  *
492  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
493  * on error.
494  *
495  * Syntax:
496  *      i2c crc32 {i2c_chip} {addr}{.0, .1, .2} {count}
497  */
498 static int do_i2c_crc (cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
500         uchar   chip;
501         ulong   addr;
502         uint    alen;
503         int     count;
504         uchar   byte;
505         ulong   crc;
506         ulong   err;
508         if (argc < 4)
509                 return CMD_RET_USAGE;
511         /*
512          * Chip is always specified.
513          */
514         chip = simple_strtoul(argv[1], NULL, 16);
516         /*
517          * Address is always specified.
518          */
519         addr = simple_strtoul(argv[2], NULL, 16);
520         alen = get_alen(argv[2]);
521         if (alen > 3)
522                 return CMD_RET_USAGE;
524         /*
525          * Count is always specified
526          */
527         count = simple_strtoul(argv[3], NULL, 16);
529         printf ("CRC32 for %08lx ... %08lx ==> ", addr, addr + count - 1);
530         /*
531          * CRC a byte at a time.  This is going to be slooow, but hey, the
532          * memories are small and slow too so hopefully nobody notices.
533          */
534         crc = 0;
535         err = 0;
536         while (count-- > 0) {
537                 if (i2c_read(chip, addr, alen, &byte, 1) != 0)
538                         err++;
539                 crc = crc32 (crc, &byte, 1);
540                 addr++;
541         }
542         if (err > 0)
543                 puts ("Error reading the chip,\n");
544         else
545                 printf ("%08lx\n", crc);
547         return 0;
550 /**
551  * mod_i2c_mem() - Handle the "i2c mm" and "i2c nm" command-line command
552  * @cmdtp:      Command data struct pointer
553  * @flag:       Command flag
554  * @argc:       Command-line argument count
555  * @argv:       Array of command-line arguments
556  *
557  * Modify memory.
558  *
559  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
560  * on error.
561  *
562  * Syntax:
563  *      i2c mm{.b, .w, .l} {i2c_chip} {addr}{.0, .1, .2}
564  *      i2c nm{.b, .w, .l} {i2c_chip} {addr}{.0, .1, .2}
565  */
566 static int
567 mod_i2c_mem(cmd_tbl_t *cmdtp, int incrflag, int flag, int argc, char * const argv[])
569         uchar   chip;
570         ulong   addr;
571         uint    alen;
572         ulong   data;
573         int     size = 1;
574         int     nbytes;
576         if (argc != 3)
577                 return CMD_RET_USAGE;
579 #ifdef CONFIG_BOOT_RETRY_TIME
580         reset_cmd_timeout();    /* got a good command to get here */
581 #endif
582         /*
583          * We use the last specified parameters, unless new ones are
584          * entered.
585          */
586         chip = i2c_mm_last_chip;
587         addr = i2c_mm_last_addr;
588         alen = i2c_mm_last_alen;
590         if ((flag & CMD_FLAG_REPEAT) == 0) {
591                 /*
592                  * New command specified.  Check for a size specification.
593                  * Defaults to byte if no or incorrect specification.
594                  */
595                 size = cmd_get_data_size(argv[0], 1);
597                 /*
598                  * Chip is always specified.
599                  */
600                 chip = simple_strtoul(argv[1], NULL, 16);
602                 /*
603                  * Address is always specified.
604                  */
605                 addr = simple_strtoul(argv[2], NULL, 16);
606                 alen = get_alen(argv[2]);
607                 if (alen > 3)
608                         return CMD_RET_USAGE;
609         }
611         /*
612          * Print the address, followed by value.  Then accept input for
613          * the next value.  A non-converted value exits.
614          */
615         do {
616                 printf("%08lx:", addr);
617                 if (i2c_read(chip, addr, alen, (uchar *)&data, size) != 0)
618                         puts ("\nError reading the chip,\n");
619                 else {
620                         data = cpu_to_be32(data);
621                         if (size == 1)
622                                 printf(" %02lx", (data >> 24) & 0x000000FF);
623                         else if (size == 2)
624                                 printf(" %04lx", (data >> 16) & 0x0000FFFF);
625                         else
626                                 printf(" %08lx", data);
627                 }
629                 nbytes = readline (" ? ");
630                 if (nbytes == 0) {
631                         /*
632                          * <CR> pressed as only input, don't modify current
633                          * location and move to next.
634                          */
635                         if (incrflag)
636                                 addr += size;
637                         nbytes = size;
638 #ifdef CONFIG_BOOT_RETRY_TIME
639                         reset_cmd_timeout(); /* good enough to not time out */
640 #endif
641                 }
642 #ifdef CONFIG_BOOT_RETRY_TIME
643                 else if (nbytes == -2)
644                         break;  /* timed out, exit the command  */
645 #endif
646                 else {
647                         char *endp;
649                         data = simple_strtoul(console_buffer, &endp, 16);
650                         if (size == 1)
651                                 data = data << 24;
652                         else if (size == 2)
653                                 data = data << 16;
654                         data = be32_to_cpu(data);
655                         nbytes = endp - console_buffer;
656                         if (nbytes) {
657 #ifdef CONFIG_BOOT_RETRY_TIME
658                                 /*
659                                  * good enough to not time out
660                                  */
661                                 reset_cmd_timeout();
662 #endif
663                                 if (i2c_write(chip, addr, alen, (uchar *)&data, size) != 0)
664                                         puts ("Error writing the chip.\n");
665 #ifdef CONFIG_SYS_EEPROM_PAGE_WRITE_DELAY_MS
666                                 udelay(CONFIG_SYS_EEPROM_PAGE_WRITE_DELAY_MS * 1000);
667 #endif
668                                 if (incrflag)
669                                         addr += size;
670                         }
671                 }
672         } while (nbytes);
674         i2c_mm_last_chip = chip;
675         i2c_mm_last_addr = addr;
676         i2c_mm_last_alen = alen;
678         return 0;
681 /**
682  * do_i2c_probe() - Handle the "i2c probe" command-line command
683  * @cmdtp:      Command data struct pointer
684  * @flag:       Command flag
685  * @argc:       Command-line argument count
686  * @argv:       Array of command-line arguments
687  *
688  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
689  * on error.
690  *
691  * Syntax:
692  *      i2c probe {addr}
693  *
694  * Returns zero (success) if one or more I2C devices was found
695  */
696 static int do_i2c_probe (cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
698         int j;
699         int addr = -1;
700         int found = 0;
701 #if defined(CONFIG_SYS_I2C_NOPROBES)
702         int k, skip;
703         uchar bus = GET_BUS_NUM;
704 #endif  /* NOPROBES */
706         if (argc == 2)
707                 addr = simple_strtol(argv[1], 0, 16);
709         puts ("Valid chip addresses:");
710         for (j = 0; j < 128; j++) {
711                 if ((0 <= addr) && (j != addr))
712                         continue;
714 #if defined(CONFIG_SYS_I2C_NOPROBES)
715                 skip = 0;
716                 for (k=0; k < NUM_ELEMENTS_NOPROBE; k++) {
717                         if (COMPARE_BUS(bus, k) && COMPARE_ADDR(j, k)) {
718                                 skip = 1;
719                                 break;
720                         }
721                 }
722                 if (skip)
723                         continue;
724 #endif
725                 if (i2c_probe(j) == 0) {
726                         printf(" %02X", j);
727                         found++;
728                 }
729         }
730         putc ('\n');
732 #if defined(CONFIG_SYS_I2C_NOPROBES)
733         puts ("Excluded chip addresses:");
734         for (k=0; k < NUM_ELEMENTS_NOPROBE; k++) {
735                 if (COMPARE_BUS(bus,k))
736                         printf(" %02X", NO_PROBE_ADDR(k));
737         }
738         putc ('\n');
739 #endif
741         return (0 == found);
744 /**
745  * do_i2c_loop() - Handle the "i2c loop" command-line command
746  * @cmdtp:      Command data struct pointer
747  * @flag:       Command flag
748  * @argc:       Command-line argument count
749  * @argv:       Array of command-line arguments
750  *
751  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
752  * on error.
753  *
754  * Syntax:
755  *      i2c loop {i2c_chip} {addr}{.0, .1, .2} [{length}] [{delay}]
756  *      {length} - Number of bytes to read
757  *      {delay}  - A DECIMAL number and defaults to 1000 uSec
758  */
759 static int do_i2c_loop(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
761         u_char  chip;
762         ulong   alen;
763         uint    addr;
764         uint    length;
765         u_char  bytes[16];
766         int     delay;
768         if (argc < 3)
769                 return CMD_RET_USAGE;
771         /*
772          * Chip is always specified.
773          */
774         chip = simple_strtoul(argv[1], NULL, 16);
776         /*
777          * Address is always specified.
778          */
779         addr = simple_strtoul(argv[2], NULL, 16);
780         alen = get_alen(argv[2]);
781         if (alen > 3)
782                 return CMD_RET_USAGE;
784         /*
785          * Length is the number of objects, not number of bytes.
786          */
787         length = 1;
788         length = simple_strtoul(argv[3], NULL, 16);
789         if (length > sizeof(bytes))
790                 length = sizeof(bytes);
792         /*
793          * The delay time (uSec) is optional.
794          */
795         delay = 1000;
796         if (argc > 3)
797                 delay = simple_strtoul(argv[4], NULL, 10);
798         /*
799          * Run the loop...
800          */
801         while (1) {
802                 if (i2c_read(chip, addr, alen, bytes, length) != 0)
803                         puts ("Error reading the chip.\n");
804                 udelay(delay);
805         }
807         /* NOTREACHED */
808         return 0;
811 /*
812  * The SDRAM command is separately configured because many
813  * (most?) embedded boards don't use SDRAM DIMMs.
814  *
815  * FIXME: Document and probably move elsewhere!
816  */
817 #if defined(CONFIG_CMD_SDRAM)
818 static void print_ddr2_tcyc (u_char const b)
820         printf ("%d.", (b >> 4) & 0x0F);
821         switch (b & 0x0F) {
822         case 0x0:
823         case 0x1:
824         case 0x2:
825         case 0x3:
826         case 0x4:
827         case 0x5:
828         case 0x6:
829         case 0x7:
830         case 0x8:
831         case 0x9:
832                 printf ("%d ns\n", b & 0x0F);
833                 break;
834         case 0xA:
835                 puts ("25 ns\n");
836                 break;
837         case 0xB:
838                 puts ("33 ns\n");
839                 break;
840         case 0xC:
841                 puts ("66 ns\n");
842                 break;
843         case 0xD:
844                 puts ("75 ns\n");
845                 break;
846         default:
847                 puts ("?? ns\n");
848                 break;
849         }
852 static void decode_bits (u_char const b, char const *str[], int const do_once)
854         u_char mask;
856         for (mask = 0x80; mask != 0x00; mask >>= 1, ++str) {
857                 if (b & mask) {
858                         puts (*str);
859                         if (do_once)
860                                 return;
861                 }
862         }
865 /*
866  * Syntax:
867  *      i2c sdram {i2c_chip}
868  */
869 static int do_sdram (cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
871         enum { unknown, EDO, SDRAM, DDR2 } type;
873         u_char  chip;
874         u_char  data[128];
875         u_char  cksum;
876         int     j;
878         static const char *decode_CAS_DDR2[] = {
879                 " TBD", " 6", " 5", " 4", " 3", " 2", " TBD", " TBD"
880         };
882         static const char *decode_CAS_default[] = {
883                 " TBD", " 7", " 6", " 5", " 4", " 3", " 2", " 1"
884         };
886         static const char *decode_CS_WE_default[] = {
887                 " TBD", " 6", " 5", " 4", " 3", " 2", " 1", " 0"
888         };
890         static const char *decode_byte21_default[] = {
891                 "  TBD (bit 7)\n",
892                 "  Redundant row address\n",
893                 "  Differential clock input\n",
894                 "  Registerd DQMB inputs\n",
895                 "  Buffered DQMB inputs\n",
896                 "  On-card PLL\n",
897                 "  Registered address/control lines\n",
898                 "  Buffered address/control lines\n"
899         };
901         static const char *decode_byte22_DDR2[] = {
902                 "  TBD (bit 7)\n",
903                 "  TBD (bit 6)\n",
904                 "  TBD (bit 5)\n",
905                 "  TBD (bit 4)\n",
906                 "  TBD (bit 3)\n",
907                 "  Supports partial array self refresh\n",
908                 "  Supports 50 ohm ODT\n",
909                 "  Supports weak driver\n"
910         };
912         static const char *decode_row_density_DDR2[] = {
913                 "512 MiB", "256 MiB", "128 MiB", "16 GiB",
914                 "8 GiB", "4 GiB", "2 GiB", "1 GiB"
915         };
917         static const char *decode_row_density_default[] = {
918                 "512 MiB", "256 MiB", "128 MiB", "64 MiB",
919                 "32 MiB", "16 MiB", "8 MiB", "4 MiB"
920         };
922         if (argc < 2)
923                 return CMD_RET_USAGE;
925         /*
926          * Chip is always specified.
927          */
928         chip = simple_strtoul (argv[1], NULL, 16);
930         if (i2c_read (chip, 0, 1, data, sizeof (data)) != 0) {
931                 puts ("No SDRAM Serial Presence Detect found.\n");
932                 return 1;
933         }
935         cksum = 0;
936         for (j = 0; j < 63; j++) {
937                 cksum += data[j];
938         }
939         if (cksum != data[63]) {
940                 printf ("WARNING: Configuration data checksum failure:\n"
941                         "  is 0x%02x, calculated 0x%02x\n", data[63], cksum);
942         }
943         printf ("SPD data revision            %d.%d\n",
944                 (data[62] >> 4) & 0x0F, data[62] & 0x0F);
945         printf ("Bytes used                   0x%02X\n", data[0]);
946         printf ("Serial memory size           0x%02X\n", 1 << data[1]);
948         puts ("Memory type                  ");
949         switch (data[2]) {
950         case 2:
951                 type = EDO;
952                 puts ("EDO\n");
953                 break;
954         case 4:
955                 type = SDRAM;
956                 puts ("SDRAM\n");
957                 break;
958         case 8:
959                 type = DDR2;
960                 puts ("DDR2\n");
961                 break;
962         default:
963                 type = unknown;
964                 puts ("unknown\n");
965                 break;
966         }
968         puts ("Row address bits             ");
969         if ((data[3] & 0x00F0) == 0)
970                 printf ("%d\n", data[3] & 0x0F);
971         else
972                 printf ("%d/%d\n", data[3] & 0x0F, (data[3] >> 4) & 0x0F);
974         puts ("Column address bits          ");
975         if ((data[4] & 0x00F0) == 0)
976                 printf ("%d\n", data[4] & 0x0F);
977         else
978                 printf ("%d/%d\n", data[4] & 0x0F, (data[4] >> 4) & 0x0F);
980         switch (type) {
981         case DDR2:
982                 printf ("Number of ranks              %d\n",
983                         (data[5] & 0x07) + 1);
984                 break;
985         default:
986                 printf ("Module rows                  %d\n", data[5]);
987                 break;
988         }
990         switch (type) {
991         case DDR2:
992                 printf ("Module data width            %d bits\n", data[6]);
993                 break;
994         default:
995                 printf ("Module data width            %d bits\n",
996                         (data[7] << 8) | data[6]);
997                 break;
998         }
1000         puts ("Interface signal levels      ");
1001         switch(data[8]) {
1002                 case 0:  puts ("TTL 5.0 V\n");  break;
1003                 case 1:  puts ("LVTTL\n");      break;
1004                 case 2:  puts ("HSTL 1.5 V\n"); break;
1005                 case 3:  puts ("SSTL 3.3 V\n"); break;
1006                 case 4:  puts ("SSTL 2.5 V\n"); break;
1007                 case 5:  puts ("SSTL 1.8 V\n"); break;
1008                 default: puts ("unknown\n");    break;
1009         }
1011         switch (type) {
1012         case DDR2:
1013                 printf ("SDRAM cycle time             ");
1014                 print_ddr2_tcyc (data[9]);
1015                 break;
1016         default:
1017                 printf ("SDRAM cycle time             %d.%d ns\n",
1018                         (data[9] >> 4) & 0x0F, data[9] & 0x0F);
1019                 break;
1020         }
1022         switch (type) {
1023         case DDR2:
1024                 printf ("SDRAM access time            0.%d%d ns\n",
1025                         (data[10] >> 4) & 0x0F, data[10] & 0x0F);
1026                 break;
1027         default:
1028                 printf ("SDRAM access time            %d.%d ns\n",
1029                         (data[10] >> 4) & 0x0F, data[10] & 0x0F);
1030                 break;
1031         }
1033         puts ("EDC configuration            ");
1034         switch (data[11]) {
1035                 case 0:  puts ("None\n");       break;
1036                 case 1:  puts ("Parity\n");     break;
1037                 case 2:  puts ("ECC\n");        break;
1038                 default: puts ("unknown\n");    break;
1039         }
1041         if ((data[12] & 0x80) == 0)
1042                 puts ("No self refresh, rate        ");
1043         else
1044                 puts ("Self refresh, rate           ");
1046         switch(data[12] & 0x7F) {
1047                 case 0:  puts ("15.625 us\n");  break;
1048                 case 1:  puts ("3.9 us\n");     break;
1049                 case 2:  puts ("7.8 us\n");     break;
1050                 case 3:  puts ("31.3 us\n");    break;
1051                 case 4:  puts ("62.5 us\n");    break;
1052                 case 5:  puts ("125 us\n");     break;
1053                 default: puts ("unknown\n");    break;
1054         }
1056         switch (type) {
1057         case DDR2:
1058                 printf ("SDRAM width (primary)        %d\n", data[13]);
1059                 break;
1060         default:
1061                 printf ("SDRAM width (primary)        %d\n", data[13] & 0x7F);
1062                 if ((data[13] & 0x80) != 0) {
1063                         printf ("  (second bank)              %d\n",
1064                                 2 * (data[13] & 0x7F));
1065                 }
1066                 break;
1067         }
1069         switch (type) {
1070         case DDR2:
1071                 if (data[14] != 0)
1072                         printf ("EDC width                    %d\n", data[14]);
1073                 break;
1074         default:
1075                 if (data[14] != 0) {
1076                         printf ("EDC width                    %d\n",
1077                                 data[14] & 0x7F);
1079                         if ((data[14] & 0x80) != 0) {
1080                                 printf ("  (second bank)              %d\n",
1081                                         2 * (data[14] & 0x7F));
1082                         }
1083                 }
1084                 break;
1085         }
1087         if (DDR2 != type) {
1088                 printf ("Min clock delay, back-to-back random column addresses "
1089                         "%d\n", data[15]);
1090         }
1092         puts ("Burst length(s)             ");
1093         if (data[16] & 0x80) puts (" Page");
1094         if (data[16] & 0x08) puts (" 8");
1095         if (data[16] & 0x04) puts (" 4");
1096         if (data[16] & 0x02) puts (" 2");
1097         if (data[16] & 0x01) puts (" 1");
1098         putc ('\n');
1099         printf ("Number of banks              %d\n", data[17]);
1101         switch (type) {
1102         case DDR2:
1103                 puts ("CAS latency(s)              ");
1104                 decode_bits (data[18], decode_CAS_DDR2, 0);
1105                 putc ('\n');
1106                 break;
1107         default:
1108                 puts ("CAS latency(s)              ");
1109                 decode_bits (data[18], decode_CAS_default, 0);
1110                 putc ('\n');
1111                 break;
1112         }
1114         if (DDR2 != type) {
1115                 puts ("CS latency(s)               ");
1116                 decode_bits (data[19], decode_CS_WE_default, 0);
1117                 putc ('\n');
1118         }
1120         if (DDR2 != type) {
1121                 puts ("WE latency(s)               ");
1122                 decode_bits (data[20], decode_CS_WE_default, 0);
1123                 putc ('\n');
1124         }
1126         switch (type) {
1127         case DDR2:
1128                 puts ("Module attributes:\n");
1129                 if (data[21] & 0x80)
1130                         puts ("  TBD (bit 7)\n");
1131                 if (data[21] & 0x40)
1132                         puts ("  Analysis probe installed\n");
1133                 if (data[21] & 0x20)
1134                         puts ("  TBD (bit 5)\n");
1135                 if (data[21] & 0x10)
1136                         puts ("  FET switch external enable\n");
1137                 printf ("  %d PLLs on DIMM\n", (data[21] >> 2) & 0x03);
1138                 if (data[20] & 0x11) {
1139                         printf ("  %d active registers on DIMM\n",
1140                                 (data[21] & 0x03) + 1);
1141                 }
1142                 break;
1143         default:
1144                 puts ("Module attributes:\n");
1145                 if (!data[21])
1146                         puts ("  (none)\n");
1147                 else
1148                         decode_bits (data[21], decode_byte21_default, 0);
1149                 break;
1150         }
1152         switch (type) {
1153         case DDR2:
1154                 decode_bits (data[22], decode_byte22_DDR2, 0);
1155                 break;
1156         default:
1157                 puts ("Device attributes:\n");
1158                 if (data[22] & 0x80) puts ("  TBD (bit 7)\n");
1159                 if (data[22] & 0x40) puts ("  TBD (bit 6)\n");
1160                 if (data[22] & 0x20) puts ("  Upper Vcc tolerance 5%\n");
1161                 else                 puts ("  Upper Vcc tolerance 10%\n");
1162                 if (data[22] & 0x10) puts ("  Lower Vcc tolerance 5%\n");
1163                 else                 puts ("  Lower Vcc tolerance 10%\n");
1164                 if (data[22] & 0x08) puts ("  Supports write1/read burst\n");
1165                 if (data[22] & 0x04) puts ("  Supports precharge all\n");
1166                 if (data[22] & 0x02) puts ("  Supports auto precharge\n");
1167                 if (data[22] & 0x01) puts ("  Supports early RAS# precharge\n");
1168                 break;
1169         }
1171         switch (type) {
1172         case DDR2:
1173                 printf ("SDRAM cycle time (2nd highest CAS latency)        ");
1174                 print_ddr2_tcyc (data[23]);
1175                 break;
1176         default:
1177                 printf ("SDRAM cycle time (2nd highest CAS latency)        %d."
1178                         "%d ns\n", (data[23] >> 4) & 0x0F, data[23] & 0x0F);
1179                 break;
1180         }
1182         switch (type) {
1183         case DDR2:
1184                 printf ("SDRAM access from clock (2nd highest CAS latency) 0."
1185                         "%d%d ns\n", (data[24] >> 4) & 0x0F, data[24] & 0x0F);
1186                 break;
1187         default:
1188                 printf ("SDRAM access from clock (2nd highest CAS latency) %d."
1189                         "%d ns\n", (data[24] >> 4) & 0x0F, data[24] & 0x0F);
1190                 break;
1191         }
1193         switch (type) {
1194         case DDR2:
1195                 printf ("SDRAM cycle time (3rd highest CAS latency)        ");
1196                 print_ddr2_tcyc (data[25]);
1197                 break;
1198         default:
1199                 printf ("SDRAM cycle time (3rd highest CAS latency)        %d."
1200                         "%d ns\n", (data[25] >> 4) & 0x0F, data[25] & 0x0F);
1201                 break;
1202         }
1204         switch (type) {
1205         case DDR2:
1206                 printf ("SDRAM access from clock (3rd highest CAS latency) 0."
1207                         "%d%d ns\n", (data[26] >> 4) & 0x0F, data[26] & 0x0F);
1208                 break;
1209         default:
1210                 printf ("SDRAM access from clock (3rd highest CAS latency) %d."
1211                         "%d ns\n", (data[26] >> 4) & 0x0F, data[26] & 0x0F);
1212                 break;
1213         }
1215         switch (type) {
1216         case DDR2:
1217                 printf ("Minimum row precharge        %d.%02d ns\n",
1218                         (data[27] >> 2) & 0x3F, 25 * (data[27] & 0x03));
1219                 break;
1220         default:
1221                 printf ("Minimum row precharge        %d ns\n", data[27]);
1222                 break;
1223         }
1225         switch (type) {
1226         case DDR2:
1227                 printf ("Row active to row active min %d.%02d ns\n",
1228                         (data[28] >> 2) & 0x3F, 25 * (data[28] & 0x03));
1229                 break;
1230         default:
1231                 printf ("Row active to row active min %d ns\n", data[28]);
1232                 break;
1233         }
1235         switch (type) {
1236         case DDR2:
1237                 printf ("RAS to CAS delay min         %d.%02d ns\n",
1238                         (data[29] >> 2) & 0x3F, 25 * (data[29] & 0x03));
1239                 break;
1240         default:
1241                 printf ("RAS to CAS delay min         %d ns\n", data[29]);
1242                 break;
1243         }
1245         printf ("Minimum RAS pulse width      %d ns\n", data[30]);
1247         switch (type) {
1248         case DDR2:
1249                 puts ("Density of each row          ");
1250                 decode_bits (data[31], decode_row_density_DDR2, 1);
1251                 putc ('\n');
1252                 break;
1253         default:
1254                 puts ("Density of each row          ");
1255                 decode_bits (data[31], decode_row_density_default, 1);
1256                 putc ('\n');
1257                 break;
1258         }
1260         switch (type) {
1261         case DDR2:
1262                 puts ("Command and Address setup    ");
1263                 if (data[32] >= 0xA0) {
1264                         printf ("1.%d%d ns\n",
1265                                 ((data[32] >> 4) & 0x0F) - 10, data[32] & 0x0F);
1266                 } else {
1267                         printf ("0.%d%d ns\n",
1268                                 ((data[32] >> 4) & 0x0F), data[32] & 0x0F);
1269                 }
1270                 break;
1271         default:
1272                 printf ("Command and Address setup    %c%d.%d ns\n",
1273                         (data[32] & 0x80) ? '-' : '+',
1274                         (data[32] >> 4) & 0x07, data[32] & 0x0F);
1275                 break;
1276         }
1278         switch (type) {
1279         case DDR2:
1280                 puts ("Command and Address hold     ");
1281                 if (data[33] >= 0xA0) {
1282                         printf ("1.%d%d ns\n",
1283                                 ((data[33] >> 4) & 0x0F) - 10, data[33] & 0x0F);
1284                 } else {
1285                         printf ("0.%d%d ns\n",
1286                                 ((data[33] >> 4) & 0x0F), data[33] & 0x0F);
1287                 }
1288                 break;
1289         default:
1290                 printf ("Command and Address hold     %c%d.%d ns\n",
1291                         (data[33] & 0x80) ? '-' : '+',
1292                         (data[33] >> 4) & 0x07, data[33] & 0x0F);
1293                 break;
1294         }
1296         switch (type) {
1297         case DDR2:
1298                 printf ("Data signal input setup      0.%d%d ns\n",
1299                         (data[34] >> 4) & 0x0F, data[34] & 0x0F);
1300                 break;
1301         default:
1302                 printf ("Data signal input setup      %c%d.%d ns\n",
1303                         (data[34] & 0x80) ? '-' : '+',
1304                         (data[34] >> 4) & 0x07, data[34] & 0x0F);
1305                 break;
1306         }
1308         switch (type) {
1309         case DDR2:
1310                 printf ("Data signal input hold       0.%d%d ns\n",
1311                         (data[35] >> 4) & 0x0F, data[35] & 0x0F);
1312                 break;
1313         default:
1314                 printf ("Data signal input hold       %c%d.%d ns\n",
1315                         (data[35] & 0x80) ? '-' : '+',
1316                         (data[35] >> 4) & 0x07, data[35] & 0x0F);
1317                 break;
1318         }
1320         puts ("Manufacturer's JEDEC ID      ");
1321         for (j = 64; j <= 71; j++)
1322                 printf ("%02X ", data[j]);
1323         putc ('\n');
1324         printf ("Manufacturing Location       %02X\n", data[72]);
1325         puts ("Manufacturer's Part Number   ");
1326         for (j = 73; j <= 90; j++)
1327                 printf ("%02X ", data[j]);
1328         putc ('\n');
1329         printf ("Revision Code                %02X %02X\n", data[91], data[92]);
1330         printf ("Manufacturing Date           %02X %02X\n", data[93], data[94]);
1331         puts ("Assembly Serial Number       ");
1332         for (j = 95; j <= 98; j++)
1333                 printf ("%02X ", data[j]);
1334         putc ('\n');
1336         if (DDR2 != type) {
1337                 printf ("Speed rating                 PC%d\n",
1338                         data[126] == 0x66 ? 66 : data[126]);
1339         }
1340         return 0;
1342 #endif
1344 /*
1345  * Syntax:
1346  *      i2c edid {i2c_chip}
1347  */
1348 #if defined(CONFIG_I2C_EDID)
1349 int do_edid(cmd_tbl_t *cmdtp, int flag, int argc, char *const argv[])
1351         u_char chip;
1352         struct edid1_info edid;
1354         if (argc < 2) {
1355                 cmd_usage(cmdtp);
1356                 return 1;
1357         }
1359         chip = simple_strtoul(argv[1], NULL, 16);
1360         if (i2c_read(chip, 0, 1, (uchar *)&edid, sizeof(edid)) != 0) {
1361                 puts("Error reading EDID content.\n");
1362                 return 1;
1363         }
1365         if (edid_check_info(&edid)) {
1366                 puts("Content isn't valid EDID.\n");
1367                 return 1;
1368         }
1370         edid_print_info(&edid);
1371         return 0;
1374 #endif /* CONFIG_I2C_EDID */
1376 #if defined(CONFIG_I2C_MUX)
1377 /**
1378  * do_i2c_add_bus() - Handle the "i2c bus" command-line command
1379  * @cmdtp:      Command data struct pointer
1380  * @flag:       Command flag
1381  * @argc:       Command-line argument count
1382  * @argv:       Array of command-line arguments
1383  *
1384  * Returns zero always.
1385  */
1386 static int do_i2c_add_bus(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1388         int ret=0;
1390         if (argc == 1) {
1391                 /* show all busses */
1392                 I2C_MUX         *mux;
1393                 I2C_MUX_DEVICE  *device = i2c_mux_devices;
1395                 printf ("Busses reached over muxes:\n");
1396                 while (device != NULL) {
1397                         printf ("Bus ID: %x\n", device->busid);
1398                         printf ("  reached over Mux(es):\n");
1399                         mux = device->mux;
1400                         while (mux != NULL) {
1401                                 printf ("    %s@%x ch: %x\n", mux->name, mux->chip, mux->channel);
1402                                 mux = mux->next;
1403                         }
1404                         device = device->next;
1405                 }
1406         } else {
1407                 (void)i2c_mux_ident_muxstring ((uchar *)argv[1]);
1408                 ret = 0;
1409         }
1410         return ret;
1412 #endif  /* CONFIG_I2C_MUX */
1414 #if defined(CONFIG_I2C_MULTI_BUS)
1415 /**
1416  * do_i2c_bus_num() - Handle the "i2c dev" command-line command
1417  * @cmdtp:      Command data struct pointer
1418  * @flag:       Command flag
1419  * @argc:       Command-line argument count
1420  * @argv:       Array of command-line arguments
1421  *
1422  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1423  * on error.
1424  */
1425 static int do_i2c_bus_num(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1427         int bus_idx, ret=0;
1429         if (argc == 1)
1430                 /* querying current setting */
1431                 printf("Current bus is %d\n", i2c_get_bus_num());
1432         else {
1433                 bus_idx = simple_strtoul(argv[1], NULL, 10);
1434                 printf("Setting bus to %d\n", bus_idx);
1435                 ret = i2c_set_bus_num(bus_idx);
1436                 if (ret)
1437                         printf("Failure changing bus number (%d)\n", ret);
1438         }
1439         return ret;
1441 #endif  /* CONFIG_I2C_MULTI_BUS */
1443 /**
1444  * do_i2c_bus_speed() - Handle the "i2c speed" command-line command
1445  * @cmdtp:      Command data struct pointer
1446  * @flag:       Command flag
1447  * @argc:       Command-line argument count
1448  * @argv:       Array of command-line arguments
1449  *
1450  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1451  * on error.
1452  */
1453 static int do_i2c_bus_speed(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1455         int speed, ret=0;
1457         if (argc == 1)
1458                 /* querying current speed */
1459                 printf("Current bus speed=%d\n", i2c_get_bus_speed());
1460         else {
1461                 speed = simple_strtoul(argv[1], NULL, 10);
1462                 printf("Setting bus speed to %d Hz\n", speed);
1463                 ret = i2c_set_bus_speed(speed);
1464                 if (ret)
1465                         printf("Failure changing bus speed (%d)\n", ret);
1466         }
1467         return ret;
1470 /**
1471  * do_i2c_mm() - Handle the "i2c mm" command-line command
1472  * @cmdtp:      Command data struct pointer
1473  * @flag:       Command flag
1474  * @argc:       Command-line argument count
1475  * @argv:       Array of command-line arguments
1476  *
1477  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1478  * on error.
1479  */
1480 static int do_i2c_mm(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1482         return mod_i2c_mem (cmdtp, 1, flag, argc, argv);
1485 /**
1486  * do_i2c_nm() - Handle the "i2c nm" command-line command
1487  * @cmdtp:      Command data struct pointer
1488  * @flag:       Command flag
1489  * @argc:       Command-line argument count
1490  * @argv:       Array of command-line arguments
1491  *
1492  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1493  * on error.
1494  */
1495 static int do_i2c_nm(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1497         return mod_i2c_mem (cmdtp, 0, flag, argc, argv);
1500 /**
1501  * do_i2c_reset() - Handle the "i2c reset" command-line command
1502  * @cmdtp:      Command data struct pointer
1503  * @flag:       Command flag
1504  * @argc:       Command-line argument count
1505  * @argv:       Array of command-line arguments
1506  *
1507  * Returns zero always.
1508  */
1509 static int do_i2c_reset(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1511         i2c_init(CONFIG_SYS_I2C_SPEED, CONFIG_SYS_I2C_SLAVE);
1512         return 0;
1515 static cmd_tbl_t cmd_i2c_sub[] = {
1516 #if defined(CONFIG_I2C_MUX)
1517         U_BOOT_CMD_MKENT(bus, 1, 1, do_i2c_add_bus, "", ""),
1518 #endif  /* CONFIG_I2C_MUX */
1519         U_BOOT_CMD_MKENT(crc32, 3, 1, do_i2c_crc, "", ""),
1520 #if defined(CONFIG_I2C_MULTI_BUS)
1521         U_BOOT_CMD_MKENT(dev, 1, 1, do_i2c_bus_num, "", ""),
1522 #endif  /* CONFIG_I2C_MULTI_BUS */
1523 #if defined(CONFIG_I2C_EDID)
1524         U_BOOT_CMD_MKENT(edid, 1, 1, do_edid, "", ""),
1525 #endif  /* CONFIG_I2C_EDID */
1526         U_BOOT_CMD_MKENT(loop, 3, 1, do_i2c_loop, "", ""),
1527         U_BOOT_CMD_MKENT(md, 3, 1, do_i2c_md, "", ""),
1528         U_BOOT_CMD_MKENT(mm, 2, 1, do_i2c_mm, "", ""),
1529         U_BOOT_CMD_MKENT(mw, 3, 1, do_i2c_mw, "", ""),
1530         U_BOOT_CMD_MKENT(nm, 2, 1, do_i2c_nm, "", ""),
1531         U_BOOT_CMD_MKENT(probe, 0, 1, do_i2c_probe, "", ""),
1532         U_BOOT_CMD_MKENT(read, 5, 1, do_i2c_read, "", ""),
1533         U_BOOT_CMD_MKENT(write, 5, 0, do_i2c_write, "", ""),
1534         U_BOOT_CMD_MKENT(reset, 0, 1, do_i2c_reset, "", ""),
1535 #if defined(CONFIG_CMD_SDRAM)
1536         U_BOOT_CMD_MKENT(sdram, 1, 1, do_sdram, "", ""),
1537 #endif
1538         U_BOOT_CMD_MKENT(speed, 1, 1, do_i2c_bus_speed, "", ""),
1539 };
1541 #ifdef CONFIG_NEEDS_MANUAL_RELOC
1542 void i2c_reloc(void) {
1543         fixup_cmdtable(cmd_i2c_sub, ARRAY_SIZE(cmd_i2c_sub));
1545 #endif
1547 /**
1548  * do_i2c() - Handle the "i2c" command-line command
1549  * @cmdtp:      Command data struct pointer
1550  * @flag:       Command flag
1551  * @argc:       Command-line argument count
1552  * @argv:       Array of command-line arguments
1553  *
1554  * Returns zero on success, CMD_RET_USAGE in case of misuse and negative
1555  * on error.
1556  */
1557 static int do_i2c(cmd_tbl_t * cmdtp, int flag, int argc, char * const argv[])
1559         cmd_tbl_t *c;
1561         if (argc < 2)
1562                 return CMD_RET_USAGE;
1564         /* Strip off leading 'i2c' command argument */
1565         argc--;
1566         argv++;
1568         c = find_cmd_tbl(argv[0], &cmd_i2c_sub[0], ARRAY_SIZE(cmd_i2c_sub));
1570         if (c)
1571                 return c->cmd(cmdtp, flag, argc, argv);
1572         else
1573                 return CMD_RET_USAGE;
1576 /***************************************************/
1577 #ifdef CONFIG_SYS_LONGHELP
1578 static char i2c_help_text[] =
1579 #if defined(CONFIG_I2C_MUX)
1580         "bus [muxtype:muxaddr:muxchannel] - add a new bus reached over muxes\ni2c "
1581 #endif  /* CONFIG_I2C_MUX */
1582         "crc32 chip address[.0, .1, .2] count - compute CRC32 checksum\n"
1583 #if defined(CONFIG_I2C_MULTI_BUS)
1584         "i2c dev [dev] - show or set current I2C bus\n"
1585 #endif  /* CONFIG_I2C_MULTI_BUS */
1586 #if defined(CONFIG_I2C_EDID)
1587         "i2c edid chip - print EDID configuration information\n"
1588 #endif  /* CONFIG_I2C_EDID */
1589         "i2c loop chip address[.0, .1, .2] [# of objects] - looping read of device\n"
1590         "i2c md chip address[.0, .1, .2] [# of objects] - read from I2C device\n"
1591         "i2c mm chip address[.0, .1, .2] - write to I2C device (auto-incrementing)\n"
1592         "i2c mw chip address[.0, .1, .2] value [count] - write to I2C device (fill)\n"
1593         "i2c nm chip address[.0, .1, .2] - write to I2C device (constant address)\n"
1594         "i2c probe [address] - test for and show device(s) on the I2C bus\n"
1595         "i2c read chip address[.0, .1, .2] length memaddress - read to memory \n"
1596         "i2c write memaddress chip address[.0, .1, .2] length - write memory to i2c\n"
1597         "i2c reset - re-init the I2C Controller\n"
1598 #if defined(CONFIG_CMD_SDRAM)
1599         "i2c sdram chip - print SDRAM configuration information\n"
1600 #endif
1601         "i2c speed [speed] - show or set I2C bus speed";
1602 #endif
1604 U_BOOT_CMD(
1605         i2c, 6, 1, do_i2c,
1606         "I2C sub-system",
1607         i2c_help_text
1608 );
1610 #if defined(CONFIG_I2C_MUX)
1611 static int i2c_mux_add_device(I2C_MUX_DEVICE *dev)
1613         I2C_MUX_DEVICE  *devtmp = i2c_mux_devices;
1615         if (i2c_mux_devices == NULL) {
1616                 i2c_mux_devices = dev;
1617                 return 0;
1618         }
1619         while (devtmp->next != NULL)
1620                 devtmp = devtmp->next;
1622         devtmp->next = dev;
1623         return 0;
1626 I2C_MUX_DEVICE  *i2c_mux_search_device(int id)
1628         I2C_MUX_DEVICE  *device = i2c_mux_devices;
1630         while (device != NULL) {
1631                 if (device->busid == id)
1632                         return device;
1633                 device = device->next;
1634         }
1635         return NULL;
1638 /* searches in the buf from *pos the next ':'.
1639  * returns:
1640  *     0 if found (with *pos = where)
1641  *   < 0 if an error occured
1642  *   > 0 if the end of buf is reached
1643  */
1644 static int i2c_mux_search_next (int *pos, uchar *buf, int len)
1646         while ((buf[*pos] != ':') && (*pos < len)) {
1647                 *pos += 1;
1648         }
1649         if (*pos >= len)
1650                 return 1;
1651         if (buf[*pos] != ':')
1652                 return -1;
1653         return 0;
1656 static int i2c_mux_get_busid (void)
1658         int     tmp = i2c_mux_busid;
1660         i2c_mux_busid ++;
1661         return tmp;
1664 /* Analyses a Muxstring and immediately sends the
1665    commands to the muxes. Runs from flash.
1666  */
1667 int i2c_mux_ident_muxstring_f (uchar *buf)
1669         int     pos = 0;
1670         int     oldpos;
1671         int     ret = 0;
1672         int     len = strlen((char *)buf);
1673         int     chip;
1674         uchar   channel;
1675         int     was = 0;
1677         while (ret == 0) {
1678                 oldpos = pos;
1679                 /* search name */
1680                 ret = i2c_mux_search_next(&pos, buf, len);
1681                 if (ret != 0)
1682                         printf ("ERROR\n");
1683                 /* search address */
1684                 pos ++;
1685                 oldpos = pos;
1686                 ret = i2c_mux_search_next(&pos, buf, len);
1687                 if (ret != 0)
1688                         printf ("ERROR\n");
1689                 buf[pos] = 0;
1690                 chip = simple_strtoul((char *)&buf[oldpos], NULL, 16);
1691                 buf[pos] = ':';
1692                 /* search channel */
1693                 pos ++;
1694                 oldpos = pos;
1695                 ret = i2c_mux_search_next(&pos, buf, len);
1696                 if (ret < 0)
1697                         printf ("ERROR\n");
1698                 was = 0;
1699                 if (buf[pos] != 0) {
1700                         buf[pos] = 0;
1701                         was = 1;
1702                 }
1703                 channel = simple_strtoul((char *)&buf[oldpos], NULL, 16);
1704                 if (was)
1705                         buf[pos] = ':';
1706                 if (i2c_write(chip, 0, 0, &channel, 1) != 0) {
1707                         printf ("Error setting Mux: chip:%x channel: \
1708                                 %x\n", chip, channel);
1709                         return -1;
1710                 }
1711                 pos ++;
1712                 oldpos = pos;
1714         }
1715         i2c_init_board();
1717         return 0;
1720 /* Analyses a Muxstring and if this String is correct
1721  * adds a new I2C Bus.
1722  */
1723 I2C_MUX_DEVICE *i2c_mux_ident_muxstring (uchar *buf)
1725         I2C_MUX_DEVICE  *device;
1726         I2C_MUX         *mux;
1727         int     pos = 0;
1728         int     oldpos;
1729         int     ret = 0;
1730         int     len = strlen((char *)buf);
1731         int     was = 0;
1733         device = (I2C_MUX_DEVICE *)malloc (sizeof(I2C_MUX_DEVICE));
1734         device->mux = NULL;
1735         device->busid = i2c_mux_get_busid ();
1736         device->next = NULL;
1737         while (ret == 0) {
1738                 mux = (I2C_MUX *)malloc (sizeof(I2C_MUX));
1739                 mux->next = NULL;
1740                 /* search name of mux */
1741                 oldpos = pos;
1742                 ret = i2c_mux_search_next(&pos, buf, len);
1743                 if (ret != 0)
1744                         printf ("%s no name.\n", __FUNCTION__);
1745                 mux->name = (char *)malloc (pos - oldpos + 1);
1746                 memcpy (mux->name, &buf[oldpos], pos - oldpos);
1747                 mux->name[pos - oldpos] = 0;
1748                 /* search address */
1749                 pos ++;
1750                 oldpos = pos;
1751                 ret = i2c_mux_search_next(&pos, buf, len);
1752                 if (ret != 0)
1753                         printf ("%s no mux address.\n", __FUNCTION__);
1754                 buf[pos] = 0;
1755                 mux->chip = simple_strtoul((char *)&buf[oldpos], NULL, 16);
1756                 buf[pos] = ':';
1757                 /* search channel */
1758                 pos ++;
1759                 oldpos = pos;
1760                 ret = i2c_mux_search_next(&pos, buf, len);
1761                 if (ret < 0)
1762                         printf ("%s no mux channel.\n", __FUNCTION__);
1763                 was = 0;
1764                 if (buf[pos] != 0) {
1765                         buf[pos] = 0;
1766                         was = 1;
1767                 }
1768                 mux->channel = simple_strtoul((char *)&buf[oldpos], NULL, 16);
1769                 if (was)
1770                         buf[pos] = ':';
1771                 if (device->mux == NULL)
1772                         device->mux = mux;
1773                 else {
1774                         I2C_MUX         *muxtmp = device->mux;
1775                         while (muxtmp->next != NULL) {
1776                                 muxtmp = muxtmp->next;
1777                         }
1778                         muxtmp->next = mux;
1779                 }
1780                 pos ++;
1781                 oldpos = pos;
1782         }
1783         if (ret > 0) {
1784                 /* Add Device */
1785                 i2c_mux_add_device (device);
1786                 return device;
1787         }
1789         return NULL;
1792 int i2x_mux_select_mux(int bus)
1794         I2C_MUX_DEVICE  *dev;
1795         I2C_MUX         *mux;
1797         if ((gd->flags & GD_FLG_RELOC) != GD_FLG_RELOC) {
1798                 /* select Default Mux Bus */
1799 #if defined(CONFIG_SYS_I2C_IVM_BUS)
1800                 i2c_mux_ident_muxstring_f ((uchar *)CONFIG_SYS_I2C_IVM_BUS);
1801 #else
1802                 {
1803                 unsigned char *buf;
1804                 buf = (unsigned char *) getenv("EEprom_ivm");
1805                 if (buf != NULL)
1806                         i2c_mux_ident_muxstring_f (buf);
1807                 }
1808 #endif
1809                 return 0;
1810         }
1811         dev = i2c_mux_search_device(bus);
1812         if (dev == NULL)
1813                 return -1;
1815         mux = dev->mux;
1816         while (mux != NULL) {
1817                 /* do deblocking on each level of mux, before mux config */
1818                 i2c_init_board();
1819                 if (i2c_write(mux->chip, 0, 0, &mux->channel, 1) != 0) {
1820                         printf ("Error setting Mux: chip:%x channel: \
1821                                 %x\n", mux->chip, mux->channel);
1822                         return -1;
1823                 }
1824                 mux = mux->next;
1825         }
1826         /* do deblocking on each level of mux and after mux config */
1827         i2c_init_board();
1828         return 0;
1830 #endif /* CONFIG_I2C_MUX */