]>
Commit | Line | Data |
---|---|---|
b6368467 HS |
1 | /* |
2 | * Command for accessing SPI flash. | |
3 | * | |
4 | * Copyright (C) 2008 Atmel Corporation | |
4166ee58 | 5 | * Licensed under the GPL-2 or later. |
b6368467 | 6 | */ |
4166ee58 | 7 | |
b6368467 | 8 | #include <common.h> |
381c6e2c | 9 | #include <div64.h> |
8d1af942 | 10 | #include <malloc.h> |
b6368467 HS |
11 | #include <spi_flash.h> |
12 | ||
13 | #include <asm/io.h> | |
14 | ||
15 | #ifndef CONFIG_SF_DEFAULT_SPEED | |
16 | # define CONFIG_SF_DEFAULT_SPEED 1000000 | |
17 | #endif | |
18 | #ifndef CONFIG_SF_DEFAULT_MODE | |
19 | # define CONFIG_SF_DEFAULT_MODE SPI_MODE_3 | |
20 | #endif | |
c1173bd0 EN |
21 | #ifndef CONFIG_SF_DEFAULT_CS |
22 | # define CONFIG_SF_DEFAULT_CS 0 | |
23 | #endif | |
24 | #ifndef CONFIG_SF_DEFAULT_BUS | |
25 | # define CONFIG_SF_DEFAULT_BUS 0 | |
26 | #endif | |
b6368467 HS |
27 | |
28 | static struct spi_flash *flash; | |
29 | ||
334eb4b0 RR |
30 | |
31 | /* | |
32 | * This function computes the length argument for the erase command. | |
33 | * The length on which the command is to operate can be given in two forms: | |
34 | * 1. <cmd> offset len - operate on <'offset', 'len') | |
35 | * 2. <cmd> offset +len - operate on <'offset', 'round_up(len)') | |
36 | * If the second form is used and the length doesn't fall on the | |
37 | * sector boundary, than it will be adjusted to the next sector boundary. | |
38 | * If it isn't in the flash, the function will fail (return -1). | |
39 | * Input: | |
40 | * arg: length specification (i.e. both command arguments) | |
41 | * Output: | |
42 | * len: computed length for operation | |
43 | * Return: | |
44 | * 1: success | |
45 | * -1: failure (bad format, bad address). | |
46 | */ | |
47 | static int sf_parse_len_arg(char *arg, ulong *len) | |
48 | { | |
49 | char *ep; | |
50 | char round_up_len; /* indicates if the "+length" form used */ | |
51 | ulong len_arg; | |
52 | ||
53 | round_up_len = 0; | |
54 | if (*arg == '+') { | |
55 | round_up_len = 1; | |
56 | ++arg; | |
57 | } | |
58 | ||
59 | len_arg = simple_strtoul(arg, &ep, 16); | |
60 | if (ep == arg || *ep != '\0') | |
61 | return -1; | |
62 | ||
63 | if (round_up_len && flash->sector_size > 0) | |
155cfb5e | 64 | *len = ROUND(len_arg, flash->sector_size); |
334eb4b0 RR |
65 | else |
66 | *len = len_arg; | |
67 | ||
68 | return 1; | |
69 | } | |
70 | ||
a683c288 JM |
71 | /** |
72 | * This function takes a byte length and a delta unit of time to compute the | |
73 | * approximate bytes per second | |
74 | * | |
75 | * @param len amount of bytes currently processed | |
76 | * @param start_ms start time of processing in ms | |
77 | * @return bytes per second if OK, 0 on error | |
78 | */ | |
79 | static ulong bytes_per_second(unsigned int len, ulong start_ms) | |
80 | { | |
81 | /* less accurate but avoids overflow */ | |
82 | if (len >= ((unsigned int) -1) / 1024) | |
83 | return len / (max(get_timer(start_ms) / 1024, 1)); | |
84 | else | |
85 | return 1024 * len / max(get_timer(start_ms), 1); | |
86 | } | |
87 | ||
54841ab5 | 88 | static int do_spi_flash_probe(int argc, char * const argv[]) |
b6368467 | 89 | { |
c1173bd0 EN |
90 | unsigned int bus = CONFIG_SF_DEFAULT_BUS; |
91 | unsigned int cs = CONFIG_SF_DEFAULT_CS; | |
b6368467 HS |
92 | unsigned int speed = CONFIG_SF_DEFAULT_SPEED; |
93 | unsigned int mode = CONFIG_SF_DEFAULT_MODE; | |
94 | char *endp; | |
95 | struct spi_flash *new; | |
96 | ||
c1173bd0 EN |
97 | if (argc >= 2) { |
98 | cs = simple_strtoul(argv[1], &endp, 0); | |
99 | if (*argv[1] == 0 || (*endp != 0 && *endp != ':')) | |
8a07de03 | 100 | return -1; |
c1173bd0 EN |
101 | if (*endp == ':') { |
102 | if (endp[1] == 0) | |
103 | return -1; | |
104 | ||
105 | bus = cs; | |
106 | cs = simple_strtoul(endp + 1, &endp, 0); | |
107 | if (*endp != 0) | |
108 | return -1; | |
109 | } | |
b6368467 HS |
110 | } |
111 | ||
112 | if (argc >= 3) { | |
113 | speed = simple_strtoul(argv[2], &endp, 0); | |
114 | if (*argv[2] == 0 || *endp != 0) | |
8a07de03 | 115 | return -1; |
b6368467 HS |
116 | } |
117 | if (argc >= 4) { | |
6e8d58d3 | 118 | mode = simple_strtoul(argv[3], &endp, 16); |
b6368467 | 119 | if (*argv[3] == 0 || *endp != 0) |
8a07de03 | 120 | return -1; |
b6368467 HS |
121 | } |
122 | ||
123 | new = spi_flash_probe(bus, cs, speed, mode); | |
124 | if (!new) { | |
125 | printf("Failed to initialize SPI flash at %u:%u\n", bus, cs); | |
126 | return 1; | |
127 | } | |
128 | ||
129 | if (flash) | |
130 | spi_flash_free(flash); | |
131 | flash = new; | |
132 | ||
b6368467 | 133 | return 0; |
b6368467 HS |
134 | } |
135 | ||
8d1af942 SG |
136 | /** |
137 | * Write a block of data to SPI flash, first checking if it is different from | |
138 | * what is already there. | |
139 | * | |
140 | * If the data being written is the same, then *skipped is incremented by len. | |
141 | * | |
142 | * @param flash flash context pointer | |
143 | * @param offset flash offset to write | |
144 | * @param len number of bytes to write | |
145 | * @param buf buffer to write from | |
146 | * @param cmp_buf read buffer to use to compare data | |
147 | * @param skipped Count of skipped data (incremented by this function) | |
148 | * @return NULL if OK, else a string containing the stage which failed | |
149 | */ | |
150 | static const char *spi_flash_update_block(struct spi_flash *flash, u32 offset, | |
151 | size_t len, const char *buf, char *cmp_buf, size_t *skipped) | |
152 | { | |
a97f6efd | 153 | debug("offset=%#x, sector_size=%#x, len=%#zx\n", |
8d1af942 SG |
154 | offset, flash->sector_size, len); |
155 | if (spi_flash_read(flash, offset, len, cmp_buf)) | |
156 | return "read"; | |
157 | if (memcmp(cmp_buf, buf, len) == 0) { | |
a97f6efd | 158 | debug("Skip region %x size %zx: no change\n", |
8d1af942 SG |
159 | offset, len); |
160 | *skipped += len; | |
161 | return NULL; | |
162 | } | |
163 | if (spi_flash_erase(flash, offset, len)) | |
164 | return "erase"; | |
165 | if (spi_flash_write(flash, offset, len, buf)) | |
166 | return "write"; | |
167 | return NULL; | |
168 | } | |
169 | ||
170 | /** | |
171 | * Update an area of SPI flash by erasing and writing any blocks which need | |
172 | * to change. Existing blocks with the correct data are left unchanged. | |
173 | * | |
174 | * @param flash flash context pointer | |
175 | * @param offset flash offset to write | |
176 | * @param len number of bytes to write | |
177 | * @param buf buffer to write from | |
178 | * @return 0 if ok, 1 on error | |
179 | */ | |
180 | static int spi_flash_update(struct spi_flash *flash, u32 offset, | |
181 | size_t len, const char *buf) | |
182 | { | |
183 | const char *err_oper = NULL; | |
184 | char *cmp_buf; | |
185 | const char *end = buf + len; | |
186 | size_t todo; /* number of bytes to do in this pass */ | |
8e8a4bc2 | 187 | size_t skipped = 0; /* statistics */ |
a683c288 JM |
188 | const ulong start_time = get_timer(0); |
189 | size_t scale = 1; | |
190 | const char *start_buf = buf; | |
191 | ulong delta; | |
8d1af942 | 192 | |
a683c288 JM |
193 | if (end - buf >= 200) |
194 | scale = (end - buf) / 100; | |
8d1af942 SG |
195 | cmp_buf = malloc(flash->sector_size); |
196 | if (cmp_buf) { | |
a683c288 JM |
197 | ulong last_update = get_timer(0); |
198 | ||
8e8a4bc2 | 199 | for (; buf < end && !err_oper; buf += todo, offset += todo) { |
8d1af942 | 200 | todo = min(end - buf, flash->sector_size); |
a683c288 JM |
201 | if (get_timer(last_update) > 100) { |
202 | printf(" \rUpdating, %zu%% %lu B/s", | |
203 | 100 - (end - buf) / scale, | |
204 | bytes_per_second(buf - start_buf, | |
205 | start_time)); | |
206 | last_update = get_timer(0); | |
207 | } | |
8d1af942 SG |
208 | err_oper = spi_flash_update_block(flash, offset, todo, |
209 | buf, cmp_buf, &skipped); | |
210 | } | |
211 | } else { | |
212 | err_oper = "malloc"; | |
213 | } | |
214 | free(cmp_buf); | |
a683c288 | 215 | putc('\r'); |
8d1af942 SG |
216 | if (err_oper) { |
217 | printf("SPI flash failed in %s step\n", err_oper); | |
218 | return 1; | |
219 | } | |
a683c288 JM |
220 | |
221 | delta = get_timer(start_time); | |
222 | printf("%zu bytes written, %zu bytes skipped", len - skipped, | |
223 | skipped); | |
224 | printf(" in %ld.%lds, speed %ld B/s\n", | |
225 | delta / 1000, delta % 1000, bytes_per_second(len, start_time)); | |
8e8a4bc2 | 226 | |
8d1af942 SG |
227 | return 0; |
228 | } | |
229 | ||
54841ab5 | 230 | static int do_spi_flash_read_write(int argc, char * const argv[]) |
b6368467 HS |
231 | { |
232 | unsigned long addr; | |
233 | unsigned long offset; | |
234 | unsigned long len; | |
235 | void *buf; | |
236 | char *endp; | |
237 | int ret; | |
238 | ||
239 | if (argc < 4) | |
8a07de03 | 240 | return -1; |
b6368467 HS |
241 | |
242 | addr = simple_strtoul(argv[1], &endp, 16); | |
243 | if (*argv[1] == 0 || *endp != 0) | |
8a07de03 | 244 | return -1; |
b6368467 HS |
245 | offset = simple_strtoul(argv[2], &endp, 16); |
246 | if (*argv[2] == 0 || *endp != 0) | |
8a07de03 | 247 | return -1; |
b6368467 HS |
248 | len = simple_strtoul(argv[3], &endp, 16); |
249 | if (*argv[3] == 0 || *endp != 0) | |
8a07de03 | 250 | return -1; |
b6368467 | 251 | |
86493994 GF |
252 | /* Consistency checking */ |
253 | if (offset + len > flash->size) { | |
254 | printf("ERROR: attempting %s past flash size (%#x)\n", | |
255 | argv[0], flash->size); | |
256 | return 1; | |
257 | } | |
258 | ||
b6368467 HS |
259 | buf = map_physmem(addr, len, MAP_WRBACK); |
260 | if (!buf) { | |
261 | puts("Failed to map physical memory\n"); | |
262 | return 1; | |
263 | } | |
264 | ||
8d1af942 SG |
265 | if (strcmp(argv[0], "update") == 0) |
266 | ret = spi_flash_update(flash, offset, len, buf); | |
267 | else if (strcmp(argv[0], "read") == 0) | |
b6368467 HS |
268 | ret = spi_flash_read(flash, offset, len, buf); |
269 | else | |
270 | ret = spi_flash_write(flash, offset, len, buf); | |
271 | ||
272 | unmap_physmem(buf, len); | |
273 | ||
274 | if (ret) { | |
275 | printf("SPI flash %s failed\n", argv[0]); | |
276 | return 1; | |
277 | } | |
278 | ||
279 | return 0; | |
b6368467 HS |
280 | } |
281 | ||
54841ab5 | 282 | static int do_spi_flash_erase(int argc, char * const argv[]) |
b6368467 HS |
283 | { |
284 | unsigned long offset; | |
285 | unsigned long len; | |
286 | char *endp; | |
287 | int ret; | |
288 | ||
289 | if (argc < 3) | |
8a07de03 | 290 | return -1; |
b6368467 HS |
291 | |
292 | offset = simple_strtoul(argv[1], &endp, 16); | |
293 | if (*argv[1] == 0 || *endp != 0) | |
8a07de03 | 294 | return -1; |
334eb4b0 RR |
295 | |
296 | ret = sf_parse_len_arg(argv[2], &len); | |
297 | if (ret != 1) | |
8a07de03 | 298 | return -1; |
b6368467 | 299 | |
86493994 GF |
300 | /* Consistency checking */ |
301 | if (offset + len > flash->size) { | |
302 | printf("ERROR: attempting %s past flash size (%#x)\n", | |
303 | argv[0], flash->size); | |
304 | return 1; | |
305 | } | |
306 | ||
b6368467 HS |
307 | ret = spi_flash_erase(flash, offset, len); |
308 | if (ret) { | |
309 | printf("SPI flash %s failed\n", argv[0]); | |
310 | return 1; | |
311 | } | |
312 | ||
313 | return 0; | |
b6368467 HS |
314 | } |
315 | ||
24007273 SG |
316 | #ifdef CONFIG_CMD_SF_TEST |
317 | enum { | |
318 | STAGE_ERASE, | |
319 | STAGE_CHECK, | |
320 | STAGE_WRITE, | |
321 | STAGE_READ, | |
322 | ||
323 | STAGE_COUNT, | |
324 | }; | |
325 | ||
326 | static char *stage_name[STAGE_COUNT] = { | |
327 | "erase", | |
328 | "check", | |
329 | "write", | |
330 | "read", | |
331 | }; | |
332 | ||
333 | struct test_info { | |
334 | int stage; | |
335 | int bytes; | |
336 | unsigned base_ms; | |
337 | unsigned time_ms[STAGE_COUNT]; | |
338 | }; | |
339 | ||
340 | static void show_time(struct test_info *test, int stage) | |
341 | { | |
342 | uint64_t speed; /* KiB/s */ | |
343 | int bps; /* Bits per second */ | |
344 | ||
345 | speed = (long long)test->bytes * 1000; | |
346 | do_div(speed, test->time_ms[stage] * 1024); | |
347 | bps = speed * 8; | |
348 | ||
349 | printf("%d %s: %d ticks, %d KiB/s %d.%03d Mbps\n", stage, | |
350 | stage_name[stage], test->time_ms[stage], | |
351 | (int)speed, bps / 1000, bps % 1000); | |
352 | } | |
353 | ||
354 | static void spi_test_next_stage(struct test_info *test) | |
355 | { | |
356 | test->time_ms[test->stage] = get_timer(test->base_ms); | |
357 | show_time(test, test->stage); | |
358 | test->base_ms = get_timer(0); | |
359 | test->stage++; | |
360 | } | |
361 | ||
362 | /** | |
363 | * Run a test on the SPI flash | |
364 | * | |
365 | * @param flash SPI flash to use | |
366 | * @param buf Source buffer for data to write | |
367 | * @param len Size of data to read/write | |
368 | * @param offset Offset within flash to check | |
369 | * @param vbuf Verification buffer | |
370 | * @return 0 if ok, -1 on error | |
371 | */ | |
1e7133e9 SG |
372 | static int spi_flash_test(struct spi_flash *flash, uint8_t *buf, ulong len, |
373 | ulong offset, uint8_t *vbuf) | |
24007273 SG |
374 | { |
375 | struct test_info test; | |
376 | int i; | |
377 | ||
378 | printf("SPI flash test:\n"); | |
379 | memset(&test, '\0', sizeof(test)); | |
380 | test.base_ms = get_timer(0); | |
381 | test.bytes = len; | |
382 | if (spi_flash_erase(flash, offset, len)) { | |
383 | printf("Erase failed\n"); | |
384 | return -1; | |
385 | } | |
386 | spi_test_next_stage(&test); | |
387 | ||
388 | if (spi_flash_read(flash, offset, len, vbuf)) { | |
389 | printf("Check read failed\n"); | |
390 | return -1; | |
391 | } | |
392 | for (i = 0; i < len; i++) { | |
393 | if (vbuf[i] != 0xff) { | |
394 | printf("Check failed at %d\n", i); | |
395 | print_buffer(i, vbuf + i, 1, min(len - i, 0x40), 0); | |
396 | return -1; | |
397 | } | |
398 | } | |
399 | spi_test_next_stage(&test); | |
400 | ||
401 | if (spi_flash_write(flash, offset, len, buf)) { | |
402 | printf("Write failed\n"); | |
403 | return -1; | |
404 | } | |
405 | memset(vbuf, '\0', len); | |
406 | spi_test_next_stage(&test); | |
407 | ||
408 | if (spi_flash_read(flash, offset, len, vbuf)) { | |
409 | printf("Read failed\n"); | |
410 | return -1; | |
411 | } | |
412 | spi_test_next_stage(&test); | |
413 | ||
414 | for (i = 0; i < len; i++) { | |
415 | if (buf[i] != vbuf[i]) { | |
416 | printf("Verify failed at %d, good data:\n", i); | |
417 | print_buffer(i, buf + i, 1, min(len - i, 0x40), 0); | |
418 | printf("Bad data:\n"); | |
419 | print_buffer(i, vbuf + i, 1, min(len - i, 0x40), 0); | |
420 | return -1; | |
421 | } | |
422 | } | |
423 | printf("Test passed\n"); | |
424 | for (i = 0; i < STAGE_COUNT; i++) | |
425 | show_time(&test, i); | |
426 | ||
427 | return 0; | |
428 | } | |
429 | ||
430 | static int do_spi_flash_test(int argc, char * const argv[]) | |
431 | { | |
432 | unsigned long offset; | |
433 | unsigned long len; | |
1e7133e9 | 434 | uint8_t *buf = (uint8_t *)CONFIG_SYS_TEXT_BASE; |
24007273 | 435 | char *endp; |
1e7133e9 | 436 | uint8_t *vbuf; |
24007273 SG |
437 | int ret; |
438 | ||
439 | offset = simple_strtoul(argv[1], &endp, 16); | |
440 | if (*argv[1] == 0 || *endp != 0) | |
441 | return -1; | |
442 | len = simple_strtoul(argv[2], &endp, 16); | |
443 | if (*argv[2] == 0 || *endp != 0) | |
444 | return -1; | |
445 | ||
446 | vbuf = malloc(len); | |
447 | if (!vbuf) { | |
448 | printf("Cannot allocate memory\n"); | |
449 | return 1; | |
450 | } | |
451 | buf = malloc(len); | |
452 | if (!buf) { | |
453 | free(vbuf); | |
454 | printf("Cannot allocate memory\n"); | |
455 | return 1; | |
456 | } | |
457 | ||
458 | memcpy(buf, (char *)CONFIG_SYS_TEXT_BASE, len); | |
459 | ret = spi_flash_test(flash, buf, len, offset, vbuf); | |
460 | free(vbuf); | |
461 | free(buf); | |
462 | if (ret) { | |
463 | printf("Test failed\n"); | |
464 | return 1; | |
465 | } | |
466 | ||
467 | return 0; | |
468 | } | |
469 | #endif /* CONFIG_CMD_SF_TEST */ | |
470 | ||
54841ab5 | 471 | static int do_spi_flash(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[]) |
b6368467 HS |
472 | { |
473 | const char *cmd; | |
8a07de03 | 474 | int ret; |
b6368467 HS |
475 | |
476 | /* need at least two arguments */ | |
477 | if (argc < 2) | |
478 | goto usage; | |
479 | ||
480 | cmd = argv[1]; | |
8a07de03 MF |
481 | --argc; |
482 | ++argv; | |
b6368467 | 483 | |
8a07de03 MF |
484 | if (strcmp(cmd, "probe") == 0) { |
485 | ret = do_spi_flash_probe(argc, argv); | |
486 | goto done; | |
487 | } | |
b6368467 HS |
488 | |
489 | /* The remaining commands require a selected device */ | |
490 | if (!flash) { | |
491 | puts("No SPI flash selected. Please run `sf probe'\n"); | |
492 | return 1; | |
493 | } | |
494 | ||
8d1af942 SG |
495 | if (strcmp(cmd, "read") == 0 || strcmp(cmd, "write") == 0 || |
496 | strcmp(cmd, "update") == 0) | |
8a07de03 MF |
497 | ret = do_spi_flash_read_write(argc, argv); |
498 | else if (strcmp(cmd, "erase") == 0) | |
499 | ret = do_spi_flash_erase(argc, argv); | |
24007273 SG |
500 | #ifdef CONFIG_CMD_SF_TEST |
501 | else if (!strcmp(cmd, "test")) | |
502 | ret = do_spi_flash_test(argc, argv); | |
503 | #endif | |
8a07de03 MF |
504 | else |
505 | ret = -1; | |
506 | ||
507 | done: | |
508 | if (ret != -1) | |
509 | return ret; | |
b6368467 HS |
510 | |
511 | usage: | |
4c12eeb8 | 512 | return CMD_RET_USAGE; |
b6368467 HS |
513 | } |
514 | ||
24007273 SG |
515 | #ifdef CONFIG_CMD_SF_TEST |
516 | #define SF_TEST_HELP "\nsf test offset len " \ | |
517 | "- run a very basic destructive test" | |
518 | #else | |
519 | #define SF_TEST_HELP | |
520 | #endif | |
521 | ||
b6368467 HS |
522 | U_BOOT_CMD( |
523 | sf, 5, 1, do_spi_flash, | |
2fb2604d | 524 | "SPI flash sub-system", |
c1173bd0 | 525 | "probe [[bus:]cs] [hz] [mode] - init flash device on given SPI bus\n" |
b6368467 HS |
526 | " and chip select\n" |
527 | "sf read addr offset len - read `len' bytes starting at\n" | |
528 | " `offset' to memory at `addr'\n" | |
529 | "sf write addr offset len - write `len' bytes from memory\n" | |
530 | " at `addr' to flash at `offset'\n" | |
334eb4b0 | 531 | "sf erase offset [+]len - erase `len' bytes from `offset'\n" |
8d1af942 SG |
532 | " `+len' round up `len' to block size\n" |
533 | "sf update addr offset len - erase and write `len' bytes from memory\n" | |
534 | " at `addr' to flash at `offset'" | |
24007273 | 535 | SF_TEST_HELP |
a89c33db | 536 | ); |