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