cmd/i2c.c

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