3 * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
5 * See file CREDITS for list of people who contributed to this
8 * This program is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU General Public License as
10 * published by the Free Software Foundation; either version 2 of
11 * the License, or (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston,
31 #ifdef CONFIG_HAS_DATAFLASH
32 #include <dataflash.h>
35 #if (CONFIG_COMMANDS & CFG_CMD_FLASH)
37 extern flash_info_t flash_info[]; /* info for FLASH chips */
40 * The user interface starts numbering for Flash banks with 1
41 * for historical reasons.
45 * this routine looks for an abbreviated flash range specification.
46 * the syntax is B:SF[-SL], where B is the bank number, SF is the first
47 * sector to erase, and SL is the last sector to erase (defaults to SF).
48 * bank numbers start at 1 to be consistent with other specs, sector numbers
51 * returns: 1 - correct spec; *pinfo, *psf and *psl are
53 * 0 - doesn't look like an abbreviated spec
54 * -1 - looks like an abbreviated spec, but got
55 * a parsing error, a number out of range,
56 * or an invalid flash bank.
59 abbrev_spec (char *str, flash_info_t ** pinfo, int *psf, int *psl)
62 int bank, first, last;
65 if ((p = strchr (str, ':')) == NULL)
69 bank = simple_strtoul (str, &ep, 10);
70 if (ep == str || *ep != '\0' ||
71 bank < 1 || bank > CFG_MAX_FLASH_BANKS ||
72 (fp = &flash_info[bank - 1])->flash_id == FLASH_UNKNOWN)
76 if ((p = strchr (str, '-')) != NULL)
79 first = simple_strtoul (str, &ep, 10);
80 if (ep == str || *ep != '\0' || first >= fp->sector_count)
84 last = simple_strtoul (p, &ep, 10);
85 if (ep == p || *ep != '\0' ||
86 last < first || last >= fp->sector_count)
100 flash_fill_sect_ranges (ulong addr_first, ulong addr_last,
101 int *s_first, int *s_last,
110 for (bank=0; bank < CFG_MAX_FLASH_BANKS; ++bank) {
111 s_first[bank] = -1; /* first sector to erase */
112 s_last [bank] = -1; /* last sector to erase */
115 for (bank=0,info=&flash_info[0];
116 (bank < CFG_MAX_FLASH_BANKS) && (addr_first <= addr_last);
122 if (info->flash_id == FLASH_UNKNOWN) {
126 b_end = info->start[0] + info->size - 1; /* bank end addr */
127 s_end = info->sector_count - 1; /* last sector */
130 for (sect=0; sect < info->sector_count; ++sect) {
131 ulong end; /* last address in current sect */
133 end = (sect == s_end) ? b_end : info->start[sect + 1] - 1;
135 if (addr_first > end)
137 if (addr_last < info->start[sect])
140 if (addr_first == info->start[sect]) {
141 s_first[bank] = sect;
143 if (addr_last == end) {
147 if (s_first[bank] >= 0) {
148 if (s_last[bank] < 0) {
149 if (addr_last > b_end) {
150 s_last[bank] = s_end;
152 puts ("Error: end address"
153 " not on sector boundary\n");
158 if (s_last[bank] < s_first[bank]) {
159 puts ("Error: end sector"
160 " precedes start sector\n");
165 addr_first = (sect == s_end) ? b_end + 1: info->start[sect + 1];
166 (*s_count) += s_last[bank] - s_first[bank] + 1;
167 } else if (s_last[bank] >= 0) {
168 puts ("Error: cannot span across banks when they are"
169 " mapped in reverse order\n");
178 int do_flinfo ( cmd_tbl_t *cmdtp, int flag, int argc, char *argv[])
182 #ifdef CONFIG_HAS_DATAFLASH
183 dataflash_print_info();
186 if (argc == 1) { /* print info for all FLASH banks */
187 for (bank=0; bank <CFG_MAX_FLASH_BANKS; ++bank) {
188 printf ("\nBank # %ld: ", bank+1);
190 flash_print_info (&flash_info[bank]);
195 bank = simple_strtoul(argv[1], NULL, 16);
196 if ((bank < 1) || (bank > CFG_MAX_FLASH_BANKS)) {
197 printf ("Only FLASH Banks # 1 ... # %d supported\n",
198 CFG_MAX_FLASH_BANKS);
201 printf ("\nBank # %ld: ", bank);
202 flash_print_info (&flash_info[bank-1]);
205 int do_flerase (cmd_tbl_t *cmdtp, int flag, int argc, char *argv[])
208 ulong bank, addr_first, addr_last;
209 int n, sect_first, sect_last;
213 printf ("Usage:\n%s\n", cmdtp->usage);
217 if (strcmp(argv[1], "all") == 0) {
218 for (bank=1; bank<=CFG_MAX_FLASH_BANKS; ++bank) {
219 printf ("Erase Flash Bank # %ld ", bank);
220 info = &flash_info[bank-1];
221 rcode = flash_erase (info, 0, info->sector_count-1);
226 if ((n = abbrev_spec(argv[1], &info, §_first, §_last)) != 0) {
228 puts ("Bad sector specification\n");
231 printf ("Erase Flash Sectors %d-%d in Bank # %d ",
232 sect_first, sect_last, (info-flash_info)+1);
233 rcode = flash_erase(info, sect_first, sect_last);
238 printf ("Usage:\n%s\n", cmdtp->usage);
242 if (strcmp(argv[1], "bank") == 0) {
243 bank = simple_strtoul(argv[2], NULL, 16);
244 if ((bank < 1) || (bank > CFG_MAX_FLASH_BANKS)) {
245 printf ("Only FLASH Banks # 1 ... # %d supported\n",
246 CFG_MAX_FLASH_BANKS);
249 printf ("Erase Flash Bank # %ld ", bank);
250 info = &flash_info[bank-1];
251 rcode = flash_erase (info, 0, info->sector_count-1);
255 addr_first = simple_strtoul(argv[1], NULL, 16);
256 addr_last = simple_strtoul(argv[2], NULL, 16);
258 if (addr_first >= addr_last) {
259 printf ("Usage:\n%s\n", cmdtp->usage);
263 rcode = flash_sect_erase(addr_first, addr_last);
267 int flash_sect_erase (ulong addr_first, ulong addr_last)
271 int s_first[CFG_MAX_FLASH_BANKS], s_last[CFG_MAX_FLASH_BANKS];
276 rcode = flash_fill_sect_ranges (addr_first, addr_last,
277 s_first, s_last, &planned );
279 if (planned && (rcode == 0)) {
280 for (bank=0,info=&flash_info[0];
281 (bank < CFG_MAX_FLASH_BANKS) && (rcode == 0);
283 if (s_first[bank]>=0) {
284 erased += s_last[bank] - s_first[bank] + 1;
285 debug ("Erase Flash from 0x%08lx to 0x%08lx "
287 info->start[s_first[bank]],
288 (s_last[bank] == info->sector_count) ?
289 info->start[0] + info->size - 1:
290 info->start[s_last[bank]+1] - 1,
292 rcode = flash_erase (info, s_first[bank], s_last[bank]);
295 printf ("Erased %d sectors\n", erased);
296 } else if (rcode == 0) {
297 puts ("Error: start and/or end address"
298 " not on sector boundary\n");
304 int do_protect (cmd_tbl_t *cmdtp, int flag, int argc, char *argv[])
307 ulong bank, addr_first, addr_last;
308 int i, p, n, sect_first, sect_last;
310 #ifdef CONFIG_HAS_DATAFLASH
314 printf ("Usage:\n%s\n", cmdtp->usage);
318 if (strcmp(argv[1], "off") == 0) {
320 } else if (strcmp(argv[1], "on") == 0) {
323 printf ("Usage:\n%s\n", cmdtp->usage);
327 #ifdef CONFIG_HAS_DATAFLASH
328 if ((strcmp(argv[2], "all") != 0) && (strcmp(argv[2], "bank") != 0)) {
329 addr_first = simple_strtoul(argv[2], NULL, 16);
330 addr_last = simple_strtoul(argv[3], NULL, 16);
332 if (addr_dataflash(addr_first) && addr_dataflash(addr_last)) {
333 status = dataflash_real_protect(p,addr_first,addr_last);
335 puts ("Bad DataFlash sector specification\n");
338 printf("%sProtect %d DataFlash Sectors\n",
339 p ? "" : "Un-", status);
345 if (strcmp(argv[2], "all") == 0) {
346 for (bank=1; bank<=CFG_MAX_FLASH_BANKS; ++bank) {
347 info = &flash_info[bank-1];
348 if (info->flash_id == FLASH_UNKNOWN) {
351 printf ("%sProtect Flash Bank # %ld\n",
352 p ? "" : "Un-", bank);
354 for (i=0; i<info->sector_count; ++i) {
355 #if defined(CFG_FLASH_PROTECTION)
356 if (flash_real_protect(info, i, p))
360 info->protect[i] = p;
361 #endif /* CFG_FLASH_PROTECTION */
365 #if defined(CFG_FLASH_PROTECTION)
366 if (!rcode) puts (" done\n");
367 #endif /* CFG_FLASH_PROTECTION */
372 if ((n = abbrev_spec(argv[2], &info, §_first, §_last)) != 0) {
374 puts ("Bad sector specification\n");
377 printf("%sProtect Flash Sectors %d-%d in Bank # %d\n",
378 p ? "" : "Un-", sect_first, sect_last,
379 (info-flash_info)+1);
380 for (i = sect_first; i <= sect_last; i++) {
381 #if defined(CFG_FLASH_PROTECTION)
382 if (flash_real_protect(info, i, p))
386 info->protect[i] = p;
387 #endif /* CFG_FLASH_PROTECTION */
390 #if defined(CFG_FLASH_PROTECTION)
391 if (!rcode) puts (" done\n");
392 #endif /* CFG_FLASH_PROTECTION */
398 printf ("Usage:\n%s\n", cmdtp->usage);
402 if (strcmp(argv[2], "bank") == 0) {
403 bank = simple_strtoul(argv[3], NULL, 16);
404 if ((bank < 1) || (bank > CFG_MAX_FLASH_BANKS)) {
405 printf ("Only FLASH Banks # 1 ... # %d supported\n",
406 CFG_MAX_FLASH_BANKS);
409 printf ("%sProtect Flash Bank # %ld\n",
410 p ? "" : "Un-", bank);
411 info = &flash_info[bank-1];
413 if (info->flash_id == FLASH_UNKNOWN) {
414 puts ("missing or unknown FLASH type\n");
417 for (i=0; i<info->sector_count; ++i) {
418 #if defined(CFG_FLASH_PROTECTION)
419 if (flash_real_protect(info, i, p))
423 info->protect[i] = p;
424 #endif /* CFG_FLASH_PROTECTION */
427 #if defined(CFG_FLASH_PROTECTION)
428 if (!rcode) puts (" done\n");
429 #endif /* CFG_FLASH_PROTECTION */
434 addr_first = simple_strtoul(argv[2], NULL, 16);
435 addr_last = simple_strtoul(argv[3], NULL, 16);
437 if (addr_first >= addr_last) {
438 printf ("Usage:\n%s\n", cmdtp->usage);
441 rcode = flash_sect_protect (p, addr_first, addr_last);
446 int flash_sect_protect (int p, ulong addr_first, ulong addr_last)
450 int s_first[CFG_MAX_FLASH_BANKS], s_last[CFG_MAX_FLASH_BANKS];
455 rcode = flash_fill_sect_ranges( addr_first, addr_last, s_first, s_last, &planned );
459 if (planned && (rcode == 0)) {
460 for (bank=0,info=&flash_info[0]; bank < CFG_MAX_FLASH_BANKS; ++bank, ++info) {
461 if (info->flash_id == FLASH_UNKNOWN) {
465 if (s_first[bank]>=0 && s_first[bank]<=s_last[bank]) {
466 debug ("%sProtecting sectors %d..%d in bank %ld\n",
468 s_first[bank], s_last[bank], bank+1);
469 protected += s_last[bank] - s_first[bank] + 1;
470 for (i=s_first[bank]; i<=s_last[bank]; ++i) {
471 #if defined(CFG_FLASH_PROTECTION)
472 if (flash_real_protect(info, i, p))
476 info->protect[i] = p;
477 #endif /* CFG_FLASH_PROTECTION */
480 #if defined(CFG_FLASH_PROTECTION)
481 if (!rcode) putc ('\n');
482 #endif /* CFG_FLASH_PROTECTION */
485 printf ("%sProtected %d sectors\n",
486 p ? "" : "Un-", protected);
487 } else if (rcode == 0) {
488 puts ("Error: start and/or end address"
489 " not on sector boundary\n");
496 /**************************************************/
499 flinfo, 2, 1, do_flinfo,
500 "flinfo - print FLASH memory information\n",
501 "\n - print information for all FLASH memory banks\n"
502 "flinfo N\n - print information for FLASH memory bank # N\n"
506 erase, 3, 1, do_flerase,
507 "erase - erase FLASH memory\n",
509 " - erase FLASH from addr 'start' to addr 'end'\n"
510 "erase N:SF[-SL]\n - erase sectors SF-SL in FLASH bank # N\n"
511 "erase bank N\n - erase FLASH bank # N\n"
512 "erase all\n - erase all FLASH banks\n"
516 protect, 4, 1, do_protect,
517 "protect - enable or disable FLASH write protection\n",
519 " - protect FLASH from addr 'start' to addr 'end'\n"
520 "protect on N:SF[-SL]\n"
521 " - protect sectors SF-SL in FLASH bank # N\n"
522 "protect on bank N\n - protect FLASH bank # N\n"
523 "protect on all\n - protect all FLASH banks\n"
524 "protect off start end\n"
525 " - make FLASH from addr 'start' to addr 'end' writable\n"
526 "protect off N:SF[-SL]\n"
527 " - make sectors SF-SL writable in FLASH bank # N\n"
528 "protect off bank N\n - make FLASH bank # N writable\n"
529 "protect off all\n - make all FLASH banks writable\n"
532 #endif /* CFG_CMD_FLASH */