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