common: Drop flash.h from common header
[platform/kernel/u-boot.git] / cmd / flash.c
1 // SPDX-License-Identifier: GPL-2.0+
2 /*
3  * (C) Copyright 2000
4  * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
5  */
6
7 /*
8  * FLASH support
9  */
10 #include <common.h>
11 #include <command.h>
12 #include <uuid.h>
13
14 #if defined(CONFIG_CMD_MTDPARTS)
15 #include <jffs2/jffs2.h>
16
17 /* partition handling routines */
18 int mtdparts_init(void);
19 int mtd_id_parse(const char *id, const char **ret_id, u8 *dev_type, u8 *dev_num);
20 int find_dev_and_part(const char *id, struct mtd_device **dev,
21                 u8 *part_num, struct part_info **part);
22 #endif
23
24 #ifdef CONFIG_MTD_NOR_FLASH
25 #include <flash.h>
26 #include <mtd/cfi_flash.h>
27 extern flash_info_t flash_info[];       /* info for FLASH chips */
28
29 /*
30  * The user interface starts numbering for Flash banks with 1
31  * for historical reasons.
32  */
33
34 /*
35  * this routine looks for an abbreviated flash range specification.
36  * the syntax is B:SF[-SL], where B is the bank number, SF is the first
37  * sector to erase, and SL is the last sector to erase (defaults to SF).
38  * bank numbers start at 1 to be consistent with other specs, sector numbers
39  * start at zero.
40  *
41  * returns:     1       - correct spec; *pinfo, *psf and *psl are
42  *                        set appropriately
43  *              0       - doesn't look like an abbreviated spec
44  *              -1      - looks like an abbreviated spec, but got
45  *                        a parsing error, a number out of range,
46  *                        or an invalid flash bank.
47  */
48 static int
49 abbrev_spec (char *str, flash_info_t ** pinfo, int *psf, int *psl)
50 {
51         flash_info_t *fp;
52         int bank, first, last;
53         char *p, *ep;
54
55         if ((p = strchr (str, ':')) == NULL)
56                 return 0;
57         *p++ = '\0';
58
59         bank = simple_strtoul (str, &ep, 10);
60         if (ep == str || *ep != '\0' ||
61                 bank < 1 || bank > CONFIG_SYS_MAX_FLASH_BANKS ||
62                 (fp = &flash_info[bank - 1])->flash_id == FLASH_UNKNOWN)
63                 return -1;
64
65         str = p;
66         if ((p = strchr (str, '-')) != NULL)
67                 *p++ = '\0';
68
69         first = simple_strtoul (str, &ep, 10);
70         if (ep == str || *ep != '\0' || first >= fp->sector_count)
71                 return -1;
72
73         if (p != NULL) {
74                 last = simple_strtoul (p, &ep, 10);
75                 if (ep == p || *ep != '\0' ||
76                         last < first || last >= fp->sector_count)
77                         return -1;
78         } else {
79                 last = first;
80         }
81
82         *pinfo = fp;
83         *psf = first;
84         *psl = last;
85
86         return 1;
87 }
88
89 /*
90  * Take *addr in Flash and adjust it to fall on the end of its sector
91  */
92 int flash_sect_roundb(ulong *addr)
93 {
94         flash_info_t *info;
95         ulong bank, sector_end_addr;
96         char found;
97         int i;
98
99         /* find the end addr of the sector where the *addr is */
100         found = 0;
101         for (bank = 0; bank < CONFIG_SYS_MAX_FLASH_BANKS && !found; ++bank) {
102                 info = &flash_info[bank];
103                 for (i = 0; i < info->sector_count && !found; ++i) {
104                         /* get the end address of the sector */
105                         if (i == info->sector_count - 1) {
106                                 sector_end_addr = info->start[0] +
107                                                                 info->size - 1;
108                         } else {
109                                 sector_end_addr = info->start[i+1] - 1;
110                         }
111
112                         if (*addr <= sector_end_addr &&
113                                                 *addr >= info->start[i]) {
114                                 found = 1;
115                                 /* adjust *addr if necessary */
116                                 if (*addr < sector_end_addr)
117                                         *addr = sector_end_addr;
118                         } /* sector */
119                 } /* bank */
120         }
121         if (!found) {
122                 /* error, address not in flash */
123                 printf("Error: end address (0x%08lx) not in flash!\n", *addr);
124                 return 1;
125         }
126
127         return 0;
128 }
129
130 /*
131  * This function computes the start and end addresses for both
132  * erase and protect commands. The range of the addresses on which
133  * either of the commands is to operate can be given in two forms:
134  * 1. <cmd> start end - operate on <'start',  'end')
135  * 2. <cmd> start +length - operate on <'start', start + length)
136  * If the second form is used and the end address doesn't fall on the
137  * sector boundary, than it will be adjusted to the next sector boundary.
138  * If it isn't in the flash, the function will fail (return -1).
139  * Input:
140  *    arg1, arg2: address specification (i.e. both command arguments)
141  * Output:
142  *    addr_first, addr_last: computed address range
143  * Return:
144  *    1: success
145  *   -1: failure (bad format, bad address).
146 */
147 static int
148 addr_spec(char *arg1, char *arg2, ulong *addr_first, ulong *addr_last)
149 {
150         char *ep;
151         char len_used; /* indicates if the "start +length" form used */
152
153         *addr_first = simple_strtoul(arg1, &ep, 16);
154         if (ep == arg1 || *ep != '\0')
155                 return -1;
156
157         len_used = 0;
158         if (arg2 && *arg2 == '+'){
159                 len_used = 1;
160                 ++arg2;
161         }
162
163         *addr_last = simple_strtoul(arg2, &ep, 16);
164         if (ep == arg2 || *ep != '\0')
165                 return -1;
166
167         if (len_used){
168                 /*
169                  * *addr_last has the length, compute correct *addr_last
170                  * XXX watch out for the integer overflow! Right now it is
171                  * checked for in both the callers.
172                  */
173                 *addr_last = *addr_first + *addr_last - 1;
174
175                 /*
176                  * It may happen that *addr_last doesn't fall on the sector
177                  * boundary. We want to round such an address to the next
178                  * sector boundary, so that the commands don't fail later on.
179                  */
180
181                 if (flash_sect_roundb(addr_last) > 0)
182                         return -1;
183         } /* "start +length" from used */
184
185         return 1;
186 }
187
188 static int
189 flash_fill_sect_ranges (ulong addr_first, ulong addr_last,
190                         int *s_first, int *s_last,
191                         int *s_count )
192 {
193         flash_info_t *info;
194         ulong bank;
195         int rcode = 0;
196
197         *s_count = 0;
198
199         for (bank=0; bank < CONFIG_SYS_MAX_FLASH_BANKS; ++bank) {
200                 s_first[bank] = -1;     /* first sector to erase        */
201                 s_last [bank] = -1;     /* last  sector to erase        */
202         }
203
204         for (bank=0,info = &flash_info[0];
205              (bank < CONFIG_SYS_MAX_FLASH_BANKS) && (addr_first <= addr_last);
206              ++bank, ++info) {
207                 ulong b_end;
208                 int sect;
209                 short s_end;
210
211                 if (info->flash_id == FLASH_UNKNOWN) {
212                         continue;
213                 }
214
215                 b_end = info->start[0] + info->size - 1;        /* bank end addr */
216                 s_end = info->sector_count - 1;                 /* last sector   */
217
218
219                 for (sect=0; sect < info->sector_count; ++sect) {
220                         ulong end;      /* last address in current sect */
221
222                         end = (sect == s_end) ? b_end : info->start[sect + 1] - 1;
223
224                         if (addr_first > end)
225                                 continue;
226                         if (addr_last < info->start[sect])
227                                 continue;
228
229                         if (addr_first == info->start[sect]) {
230                                 s_first[bank] = sect;
231                         }
232                         if (addr_last  == end) {
233                                 s_last[bank]  = sect;
234                         }
235                 }
236                 if (s_first[bank] >= 0) {
237                         if (s_last[bank] < 0) {
238                                 if (addr_last > b_end) {
239                                         s_last[bank] = s_end;
240                                 } else {
241                                         puts ("Error: end address"
242                                                 " not on sector boundary\n");
243                                         rcode = 1;
244                                         break;
245                                 }
246                         }
247                         if (s_last[bank] < s_first[bank]) {
248                                 puts ("Error: end sector"
249                                         " precedes start sector\n");
250                                 rcode = 1;
251                                 break;
252                         }
253                         sect = s_last[bank];
254                         addr_first = (sect == s_end) ? b_end + 1: info->start[sect + 1];
255                         (*s_count) += s_last[bank] - s_first[bank] + 1;
256                 } else if (addr_first >= info->start[0] && addr_first < b_end) {
257                         puts ("Error: start address not on sector boundary\n");
258                         rcode = 1;
259                         break;
260                 } else if (s_last[bank] >= 0) {
261                         puts ("Error: cannot span across banks when they are"
262                                " mapped in reverse order\n");
263                         rcode = 1;
264                         break;
265                 }
266         }
267
268         return rcode;
269 }
270 #endif /* CONFIG_MTD_NOR_FLASH */
271
272 static int do_flinfo(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
273 {
274 #ifdef CONFIG_MTD_NOR_FLASH
275         ulong bank;
276 #endif
277
278 #ifdef CONFIG_MTD_NOR_FLASH
279         if (argc == 1) {        /* print info for all FLASH banks */
280                 for (bank=0; bank <CONFIG_SYS_MAX_FLASH_BANKS; ++bank) {
281                         printf ("\nBank # %ld: ", bank+1);
282
283                         flash_print_info(&flash_info[bank]);
284                 }
285                 return 0;
286         }
287
288         bank = simple_strtoul(argv[1], NULL, 16);
289         if ((bank < 1) || (bank > CONFIG_SYS_MAX_FLASH_BANKS)) {
290                 printf ("Only FLASH Banks # 1 ... # %d supported\n",
291                         CONFIG_SYS_MAX_FLASH_BANKS);
292                 return 1;
293         }
294         printf ("\nBank # %ld: ", bank);
295         flash_print_info(&flash_info[bank - 1]);
296 #endif /* CONFIG_MTD_NOR_FLASH */
297         return 0;
298 }
299
300 static int do_flerase(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
301 {
302 #ifdef CONFIG_MTD_NOR_FLASH
303         flash_info_t *info = NULL;
304         ulong bank, addr_first, addr_last;
305         int n, sect_first = 0, sect_last = 0;
306 #if defined(CONFIG_CMD_MTDPARTS)
307         struct mtd_device *dev;
308         struct part_info *part;
309         u8 dev_type, dev_num, pnum;
310 #endif
311         int rcode = 0;
312
313         if (argc < 2)
314                 return CMD_RET_USAGE;
315
316         if (strcmp(argv[1], "all") == 0) {
317                 for (bank=1; bank<=CONFIG_SYS_MAX_FLASH_BANKS; ++bank) {
318                         printf ("Erase Flash Bank # %ld ", bank);
319                         info = &flash_info[bank-1];
320                         rcode = flash_erase(info, 0, info->sector_count - 1);
321                 }
322                 return rcode;
323         }
324
325         if ((n = abbrev_spec(argv[1], &info, &sect_first, &sect_last)) != 0) {
326                 if (n < 0) {
327                         puts ("Bad sector specification\n");
328                         return 1;
329                 }
330                 printf ("Erase Flash Sectors %d-%d in Bank # %zu ",
331                         sect_first, sect_last, (info-flash_info)+1);
332                 rcode = flash_erase(info, sect_first, sect_last);
333                 return rcode;
334         }
335
336 #if defined(CONFIG_CMD_MTDPARTS)
337         /* erase <part-id> - erase partition */
338         if ((argc == 2) && (mtd_id_parse(argv[1], NULL, &dev_type, &dev_num) == 0)) {
339                 mtdparts_init();
340                 if (find_dev_and_part(argv[1], &dev, &pnum, &part) == 0) {
341                         if (dev->id->type == MTD_DEV_TYPE_NOR) {
342                                 bank = dev->id->num;
343                                 info = &flash_info[bank];
344                                 addr_first = part->offset + info->start[0];
345                                 addr_last = addr_first + part->size - 1;
346
347                                 printf ("Erase Flash Partition %s, "
348                                                 "bank %ld, 0x%08lx - 0x%08lx ",
349                                                 argv[1], bank, addr_first,
350                                                 addr_last);
351
352                                 rcode = flash_sect_erase(addr_first, addr_last);
353                                 return rcode;
354                         }
355
356                         printf("cannot erase, not a NOR device\n");
357                         return 1;
358                 }
359         }
360 #endif
361
362         if (argc != 3)
363                 return CMD_RET_USAGE;
364
365         if (strcmp(argv[1], "bank") == 0) {
366                 bank = simple_strtoul(argv[2], NULL, 16);
367                 if ((bank < 1) || (bank > CONFIG_SYS_MAX_FLASH_BANKS)) {
368                         printf ("Only FLASH Banks # 1 ... # %d supported\n",
369                                 CONFIG_SYS_MAX_FLASH_BANKS);
370                         return 1;
371                 }
372                 printf ("Erase Flash Bank # %ld ", bank);
373                 info = &flash_info[bank-1];
374                 rcode = flash_erase(info, 0, info->sector_count - 1);
375                 return rcode;
376         }
377
378         if (addr_spec(argv[1], argv[2], &addr_first, &addr_last) < 0){
379                 printf ("Bad address format\n");
380                 return 1;
381         }
382
383         if (addr_first >= addr_last)
384                 return CMD_RET_USAGE;
385
386         rcode = flash_sect_erase(addr_first, addr_last);
387         return rcode;
388 #else
389         return 0;
390 #endif /* CONFIG_MTD_NOR_FLASH */
391 }
392
393 #ifdef CONFIG_MTD_NOR_FLASH
394 int flash_sect_erase(ulong addr_first, ulong addr_last)
395 {
396         flash_info_t *info;
397         ulong bank;
398         int s_first[CONFIG_SYS_MAX_FLASH_BANKS], s_last[CONFIG_SYS_MAX_FLASH_BANKS];
399         int erased = 0;
400         int planned;
401         int rcode = 0;
402
403         rcode = flash_fill_sect_ranges (addr_first, addr_last,
404                                         s_first, s_last, &planned );
405
406         if (planned && (rcode == 0)) {
407                 for (bank=0,info = &flash_info[0];
408                      (bank < CONFIG_SYS_MAX_FLASH_BANKS) && (rcode == 0);
409                      ++bank, ++info) {
410                         if (s_first[bank]>=0) {
411                                 erased += s_last[bank] - s_first[bank] + 1;
412                                 debug ("Erase Flash from 0x%08lx to 0x%08lx "
413                                         "in Bank # %ld ",
414                                         info->start[s_first[bank]],
415                                         (s_last[bank] == info->sector_count) ?
416                                                 info->start[0] + info->size - 1:
417                                                 info->start[s_last[bank]+1] - 1,
418                                         bank+1);
419                                 rcode = flash_erase(info, s_first[bank],
420                                                     s_last[bank]);
421                         }
422                 }
423                 if (rcode == 0)
424                         printf("Erased %d sectors\n", erased);
425         } else if (rcode == 0) {
426                 puts ("Error: start and/or end address"
427                         " not on sector boundary\n");
428                 rcode = 1;
429         }
430         return rcode;
431 }
432 #endif /* CONFIG_MTD_NOR_FLASH */
433
434 static int do_protect(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
435 {
436         int rcode = 0;
437 #ifdef CONFIG_MTD_NOR_FLASH
438         flash_info_t *info = NULL;
439         ulong bank;
440         int i, n, sect_first = 0, sect_last = 0;
441 #if defined(CONFIG_CMD_MTDPARTS)
442         struct mtd_device *dev;
443         struct part_info *part;
444         u8 dev_type, dev_num, pnum;
445 #endif
446 #endif /* CONFIG_MTD_NOR_FLASH */
447 #if defined(CONFIG_MTD_NOR_FLASH)
448         int p;
449         ulong addr_first, addr_last;
450 #endif
451
452         if (argc < 3)
453                 return CMD_RET_USAGE;
454
455 #if defined(CONFIG_MTD_NOR_FLASH)
456         if (strcmp(argv[1], "off") == 0)
457                 p = 0;
458         else if (strcmp(argv[1], "on") == 0)
459                 p = 1;
460         else
461                 return CMD_RET_USAGE;
462 #endif
463
464 #ifdef CONFIG_MTD_NOR_FLASH
465         if (strcmp(argv[2], "all") == 0) {
466                 for (bank=1; bank<=CONFIG_SYS_MAX_FLASH_BANKS; ++bank) {
467                         info = &flash_info[bank-1];
468                         if (info->flash_id == FLASH_UNKNOWN) {
469                                 continue;
470                         }
471                         printf ("%sProtect Flash Bank # %ld\n",
472                                 p ? "" : "Un-", bank);
473
474                         for (i=0; i<info->sector_count; ++i) {
475 #if defined(CONFIG_SYS_FLASH_PROTECTION)
476                                 if (flash_real_protect(info, i, p))
477                                         rcode = 1;
478                                 putc ('.');
479 #else
480                                 info->protect[i] = p;
481 #endif  /* CONFIG_SYS_FLASH_PROTECTION */
482                         }
483 #if defined(CONFIG_SYS_FLASH_PROTECTION)
484                         if (!rcode) puts (" done\n");
485 #endif  /* CONFIG_SYS_FLASH_PROTECTION */
486                 }
487                 return rcode;
488         }
489
490         if ((n = abbrev_spec(argv[2], &info, &sect_first, &sect_last)) != 0) {
491                 if (n < 0) {
492                         puts ("Bad sector specification\n");
493                         return 1;
494                 }
495                 printf("%sProtect Flash Sectors %d-%d in Bank # %zu\n",
496                         p ? "" : "Un-", sect_first, sect_last,
497                         (info-flash_info)+1);
498                 for (i = sect_first; i <= sect_last; i++) {
499 #if defined(CONFIG_SYS_FLASH_PROTECTION)
500                         if (flash_real_protect(info, i, p))
501                                 rcode =  1;
502                         putc ('.');
503 #else
504                         info->protect[i] = p;
505 #endif  /* CONFIG_SYS_FLASH_PROTECTION */
506                 }
507
508 #if defined(CONFIG_SYS_FLASH_PROTECTION)
509                 if (!rcode) puts (" done\n");
510 #endif  /* CONFIG_SYS_FLASH_PROTECTION */
511
512                 return rcode;
513         }
514
515 #if defined(CONFIG_CMD_MTDPARTS)
516         /* protect on/off <part-id> */
517         if ((argc == 3) && (mtd_id_parse(argv[2], NULL, &dev_type, &dev_num) == 0)) {
518                 mtdparts_init();
519                 if (find_dev_and_part(argv[2], &dev, &pnum, &part) == 0) {
520                         if (dev->id->type == MTD_DEV_TYPE_NOR) {
521                                 bank = dev->id->num;
522                                 info = &flash_info[bank];
523                                 addr_first = part->offset + info->start[0];
524                                 addr_last = addr_first + part->size - 1;
525
526                                 printf ("%sProtect Flash Partition %s, "
527                                                 "bank %ld, 0x%08lx - 0x%08lx\n",
528                                                 p ? "" : "Un", argv[1],
529                                                 bank, addr_first, addr_last);
530
531                                 rcode = flash_sect_protect(p, addr_first,
532                                                            addr_last);
533                                 return rcode;
534                         }
535
536                         printf("cannot %sprotect, not a NOR device\n",
537                                         p ? "" : "un");
538                         return 1;
539                 }
540         }
541 #endif
542
543         if (argc != 4)
544                 return CMD_RET_USAGE;
545
546         if (strcmp(argv[2], "bank") == 0) {
547                 bank = simple_strtoul(argv[3], NULL, 16);
548                 if ((bank < 1) || (bank > CONFIG_SYS_MAX_FLASH_BANKS)) {
549                         printf ("Only FLASH Banks # 1 ... # %d supported\n",
550                                 CONFIG_SYS_MAX_FLASH_BANKS);
551                         return 1;
552                 }
553                 printf ("%sProtect Flash Bank # %ld\n",
554                         p ? "" : "Un-", bank);
555                 info = &flash_info[bank-1];
556
557                 if (info->flash_id == FLASH_UNKNOWN) {
558                         puts ("missing or unknown FLASH type\n");
559                         return 1;
560                 }
561                 for (i=0; i<info->sector_count; ++i) {
562 #if defined(CONFIG_SYS_FLASH_PROTECTION)
563                         if (flash_real_protect(info, i, p))
564                                 rcode =  1;
565                         putc ('.');
566 #else
567                         info->protect[i] = p;
568 #endif  /* CONFIG_SYS_FLASH_PROTECTION */
569                 }
570
571 #if defined(CONFIG_SYS_FLASH_PROTECTION)
572                 if (!rcode) puts (" done\n");
573 #endif  /* CONFIG_SYS_FLASH_PROTECTION */
574
575                 return rcode;
576         }
577
578         if (addr_spec(argv[2], argv[3], &addr_first, &addr_last) < 0){
579                 printf("Bad address format\n");
580                 return 1;
581         }
582
583         if (addr_first >= addr_last)
584                 return CMD_RET_USAGE;
585
586         rcode = flash_sect_protect(p, addr_first, addr_last);
587 #endif /* CONFIG_MTD_NOR_FLASH */
588         return rcode;
589 }
590
591 #ifdef CONFIG_MTD_NOR_FLASH
592 int flash_sect_protect(int p, ulong addr_first, ulong addr_last)
593 {
594         flash_info_t *info;
595         ulong bank;
596         int s_first[CONFIG_SYS_MAX_FLASH_BANKS], s_last[CONFIG_SYS_MAX_FLASH_BANKS];
597         int protected, i;
598         int planned;
599         int rcode;
600
601         rcode = flash_fill_sect_ranges( addr_first, addr_last, s_first, s_last, &planned );
602
603         protected = 0;
604
605         if (planned && (rcode == 0)) {
606                 for (bank=0,info = &flash_info[0]; bank < CONFIG_SYS_MAX_FLASH_BANKS; ++bank, ++info) {
607                         if (info->flash_id == FLASH_UNKNOWN) {
608                                 continue;
609                         }
610
611                         if (s_first[bank]>=0 && s_first[bank]<=s_last[bank]) {
612                                 debug ("%sProtecting sectors %d..%d in bank %ld\n",
613                                         p ? "" : "Un-",
614                                         s_first[bank], s_last[bank], bank+1);
615                                 protected += s_last[bank] - s_first[bank] + 1;
616                                 for (i=s_first[bank]; i<=s_last[bank]; ++i) {
617 #if defined(CONFIG_SYS_FLASH_PROTECTION)
618                                         if (flash_real_protect(info, i, p))
619                                                 rcode = 1;
620                                         putc ('.');
621 #else
622                                         info->protect[i] = p;
623 #endif  /* CONFIG_SYS_FLASH_PROTECTION */
624                                 }
625                         }
626                 }
627 #if defined(CONFIG_SYS_FLASH_PROTECTION)
628                 puts (" done\n");
629 #endif  /* CONFIG_SYS_FLASH_PROTECTION */
630
631                 printf ("%sProtected %d sectors\n",
632                         p ? "" : "Un-", protected);
633         } else if (rcode == 0) {
634                 puts ("Error: start and/or end address"
635                         " not on sector boundary\n");
636                 rcode = 1;
637         }
638         return rcode;
639 }
640 #endif /* CONFIG_MTD_NOR_FLASH */
641
642
643 /**************************************************/
644 #if defined(CONFIG_CMD_MTDPARTS)
645 # define TMP_ERASE      "erase <part-id>\n    - erase partition\n"
646 # define TMP_PROT_ON    "protect on <part-id>\n    - protect partition\n"
647 # define TMP_PROT_OFF   "protect off <part-id>\n    - make partition writable\n"
648 #else
649 # define TMP_ERASE      /* empty */
650 # define TMP_PROT_ON    /* empty */
651 # define TMP_PROT_OFF   /* empty */
652 #endif
653
654 U_BOOT_CMD(
655         flinfo,    2,    1,    do_flinfo,
656         "print FLASH memory information",
657         "\n    - print information for all FLASH memory banks\n"
658         "flinfo N\n    - print information for FLASH memory bank # N"
659 );
660
661 U_BOOT_CMD(
662         erase,   3,   0,  do_flerase,
663         "erase FLASH memory",
664         "start end\n"
665         "    - erase FLASH from addr 'start' to addr 'end'\n"
666         "erase start +len\n"
667         "    - erase FLASH from addr 'start' to the end of sect "
668         "w/addr 'start'+'len'-1\n"
669         "erase N:SF[-SL]\n    - erase sectors SF-SL in FLASH bank # N\n"
670         "erase bank N\n    - erase FLASH bank # N\n"
671         TMP_ERASE
672         "erase all\n    - erase all FLASH banks"
673 );
674
675 U_BOOT_CMD(
676         protect,  4,  0,   do_protect,
677         "enable or disable FLASH write protection",
678         "on  start end\n"
679         "    - protect FLASH from addr 'start' to addr 'end'\n"
680         "protect on start +len\n"
681         "    - protect FLASH from addr 'start' to end of sect "
682         "w/addr 'start'+'len'-1\n"
683         "protect on  N:SF[-SL]\n"
684         "    - protect sectors SF-SL in FLASH bank # N\n"
685         "protect on  bank N\n    - protect FLASH bank # N\n"
686         TMP_PROT_ON
687         "protect on  all\n    - protect all FLASH banks\n"
688         "protect off start end\n"
689         "    - make FLASH from addr 'start' to addr 'end' writable\n"
690         "protect off start +len\n"
691         "    - make FLASH from addr 'start' to end of sect "
692         "w/addr 'start'+'len'-1 wrtable\n"
693         "protect off N:SF[-SL]\n"
694         "    - make sectors SF-SL writable in FLASH bank # N\n"
695         "protect off bank N\n    - make FLASH bank # N writable\n"
696         TMP_PROT_OFF
697         "protect off all\n    - make all FLASH banks writable"
698 );
699
700 #undef  TMP_ERASE
701 #undef  TMP_PROT_ON
702 #undef  TMP_PROT_OFF