• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Unsorted Block Image commands
3  *
4  *  Copyright (C) 2008 Samsung Electronics
5  *  Kyungmin Park <kyungmin.park@samsung.com>
6  *
7  * Copyright 2008-2009 Stefan Roese <sr@denx.de>, DENX Software Engineering
8  *
9  * This program is free software; you can redistribute it and/or modify
10  * it under the terms of the GNU General Public License version 2 as
11  * published by the Free Software Foundation.
12  */
13 
14 #include <common.h>
15 #include <command.h>
16 #include <env.h>
17 #include <exports.h>
18 #include <memalign.h>
19 #include <mtd.h>
20 #include <nand.h>
21 #include <onenand_uboot.h>
22 #include <linux/mtd/mtd.h>
23 #include <linux/mtd/partitions.h>
24 #include <linux/err.h>
25 #include <ubi_uboot.h>
26 #include <linux/errno.h>
27 #include <jffs2/load_kernel.h>
28 
29 #undef ubi_msg
30 #define ubi_msg(fmt, ...) printf("UBI: " fmt "\n", ##__VA_ARGS__)
31 
32 /* Private own data */
33 static struct ubi_device *ubi;
34 
35 #ifdef CONFIG_CMD_UBIFS
36 #include <ubifs_uboot.h>
37 #endif
38 
display_volume_info(struct ubi_device * ubi)39 static void display_volume_info(struct ubi_device *ubi)
40 {
41 	int i;
42 
43 	for (i = 0; i < (ubi->vtbl_slots + 1); i++) {
44 		if (!ubi->volumes[i])
45 			continue;	/* Empty record */
46 		ubi_dump_vol_info(ubi->volumes[i]);
47 	}
48 }
49 
display_ubi_info(struct ubi_device * ubi)50 static void display_ubi_info(struct ubi_device *ubi)
51 {
52 	ubi_msg("MTD device name:            \"%s\"", ubi->mtd->name);
53 	ubi_msg("MTD device size:            %llu MiB", ubi->flash_size >> 20);
54 	ubi_msg("physical eraseblock size:   %d bytes (%d KiB)",
55 			ubi->peb_size, ubi->peb_size >> 10);
56 	ubi_msg("logical eraseblock size:    %d bytes", ubi->leb_size);
57 	ubi_msg("number of good PEBs:        %d", ubi->good_peb_count);
58 	ubi_msg("number of bad PEBs:         %d", ubi->bad_peb_count);
59 	ubi_msg("smallest flash I/O unit:    %d", ubi->min_io_size);
60 	ubi_msg("VID header offset:          %d (aligned %d)",
61 			ubi->vid_hdr_offset, ubi->vid_hdr_aloffset);
62 	ubi_msg("data offset:                %d", ubi->leb_start);
63 	ubi_msg("max. allowed volumes:       %d", ubi->vtbl_slots);
64 	ubi_msg("wear-leveling threshold:    %d", CONFIG_MTD_UBI_WL_THRESHOLD);
65 	ubi_msg("number of internal volumes: %d", UBI_INT_VOL_COUNT);
66 	ubi_msg("number of user volumes:     %d",
67 			ubi->vol_count - UBI_INT_VOL_COUNT);
68 	ubi_msg("available PEBs:             %d", ubi->avail_pebs);
69 	ubi_msg("total number of reserved PEBs: %d", ubi->rsvd_pebs);
70 	ubi_msg("number of PEBs reserved for bad PEB handling: %d",
71 			ubi->beb_rsvd_pebs);
72 	ubi_msg("max/mean erase counter: %d/%d", ubi->max_ec, ubi->mean_ec);
73 }
74 
ubi_info(int layout)75 static int ubi_info(int layout)
76 {
77 	if (layout)
78 		display_volume_info(ubi);
79 	else
80 		display_ubi_info(ubi);
81 
82 	return 0;
83 }
84 
ubi_check_volumename(const struct ubi_volume * vol,char * name)85 static int ubi_check_volumename(const struct ubi_volume *vol, char *name)
86 {
87 	return strcmp(vol->name, name);
88 }
89 
ubi_check(char * name)90 static int ubi_check(char *name)
91 {
92 	int i;
93 
94 	for (i = 0; i < (ubi->vtbl_slots + 1); i++) {
95 		if (!ubi->volumes[i])
96 			continue;	/* Empty record */
97 
98 		if (!ubi_check_volumename(ubi->volumes[i], name))
99 			return 0;
100 	}
101 
102 	return 1;
103 }
104 
verify_mkvol_req(const struct ubi_device * ubi,const struct ubi_mkvol_req * req)105 static int verify_mkvol_req(const struct ubi_device *ubi,
106 			    const struct ubi_mkvol_req *req)
107 {
108 	int n, err = EINVAL;
109 
110 	if (req->bytes < 0 || req->alignment < 0 || req->vol_type < 0 ||
111 	    req->name_len < 0)
112 		goto bad;
113 
114 	if ((req->vol_id < 0 || req->vol_id >= ubi->vtbl_slots) &&
115 	    req->vol_id != UBI_VOL_NUM_AUTO)
116 		goto bad;
117 
118 	if (req->alignment == 0)
119 		goto bad;
120 
121 	if (req->bytes == 0) {
122 		printf("No space left in UBI device!\n");
123 		err = ENOMEM;
124 		goto bad;
125 	}
126 
127 	if (req->vol_type != UBI_DYNAMIC_VOLUME &&
128 	    req->vol_type != UBI_STATIC_VOLUME)
129 		goto bad;
130 
131 	if (req->alignment > ubi->leb_size)
132 		goto bad;
133 
134 	n = req->alignment % ubi->min_io_size;
135 	if (req->alignment != 1 && n)
136 		goto bad;
137 
138 	if (req->name_len > UBI_VOL_NAME_MAX) {
139 		printf("Name too long!\n");
140 		err = ENAMETOOLONG;
141 		goto bad;
142 	}
143 
144 	return 0;
145 bad:
146 	return err;
147 }
148 
ubi_create_vol(char * volume,int64_t size,int dynamic,int vol_id,bool skipcheck)149 static int ubi_create_vol(char *volume, int64_t size, int dynamic, int vol_id,
150 			  bool skipcheck)
151 {
152 	struct ubi_mkvol_req req;
153 	int err;
154 
155 	if (dynamic)
156 		req.vol_type = UBI_DYNAMIC_VOLUME;
157 	else
158 		req.vol_type = UBI_STATIC_VOLUME;
159 
160 	req.vol_id = vol_id;
161 	req.alignment = 1;
162 	req.bytes = size;
163 
164 	strcpy(req.name, volume);
165 	req.name_len = strlen(volume);
166 	req.name[req.name_len] = '\0';
167 	req.flags = 0;
168 	if (skipcheck)
169 		req.flags |= UBI_VOL_SKIP_CRC_CHECK_FLG;
170 
171 	/* It's duplicated at drivers/mtd/ubi/cdev.c */
172 	err = verify_mkvol_req(ubi, &req);
173 	if (err) {
174 		printf("verify_mkvol_req failed %d\n", err);
175 		return err;
176 	}
177 	printf("Creating %s volume %s of size %lld\n",
178 		dynamic ? "dynamic" : "static", volume, size);
179 	/* Call real ubi create volume */
180 	return ubi_create_volume(ubi, &req);
181 }
182 
ubi_find_volume(char * volume)183 static struct ubi_volume *ubi_find_volume(char *volume)
184 {
185 	struct ubi_volume *vol = NULL;
186 	int i;
187 
188 	for (i = 0; i < ubi->vtbl_slots; i++) {
189 		vol = ubi->volumes[i];
190 		if (vol && !strcmp(vol->name, volume))
191 			return vol;
192 	}
193 
194 	printf("Volume %s not found!\n", volume);
195 	return NULL;
196 }
197 
ubi_remove_vol(char * volume)198 static int ubi_remove_vol(char *volume)
199 {
200 	int err, reserved_pebs, i;
201 	struct ubi_volume *vol;
202 
203 	vol = ubi_find_volume(volume);
204 	if (vol == NULL)
205 		return ENODEV;
206 
207 	printf("Remove UBI volume %s (id %d)\n", vol->name, vol->vol_id);
208 
209 	if (ubi->ro_mode) {
210 		printf("It's read-only mode\n");
211 		err = EROFS;
212 		goto out_err;
213 	}
214 
215 	err = ubi_change_vtbl_record(ubi, vol->vol_id, NULL);
216 	if (err) {
217 		printf("Error changing Vol tabel record err=%x\n", err);
218 		goto out_err;
219 	}
220 	reserved_pebs = vol->reserved_pebs;
221 	for (i = 0; i < vol->reserved_pebs; i++) {
222 		err = ubi_eba_unmap_leb(ubi, vol, i);
223 		if (err)
224 			goto out_err;
225 	}
226 
227 	kfree(vol->eba_tbl);
228 	ubi->volumes[vol->vol_id]->eba_tbl = NULL;
229 	ubi->volumes[vol->vol_id] = NULL;
230 
231 	ubi->rsvd_pebs -= reserved_pebs;
232 	ubi->avail_pebs += reserved_pebs;
233 	i = ubi->beb_rsvd_level - ubi->beb_rsvd_pebs;
234 	if (i > 0) {
235 		i = ubi->avail_pebs >= i ? i : ubi->avail_pebs;
236 		ubi->avail_pebs -= i;
237 		ubi->rsvd_pebs += i;
238 		ubi->beb_rsvd_pebs += i;
239 		if (i > 0)
240 			ubi_msg("reserve more %d PEBs", i);
241 	}
242 	ubi->vol_count -= 1;
243 
244 	return 0;
245 out_err:
246 	ubi_err(ubi, "cannot remove volume %s, error %d", volume, err);
247 	if (err < 0)
248 		err = -err;
249 	return err;
250 }
251 
ubi_volume_continue_write(char * volume,void * buf,size_t size)252 static int ubi_volume_continue_write(char *volume, void *buf, size_t size)
253 {
254 	int err = 1;
255 	struct ubi_volume *vol;
256 
257 	vol = ubi_find_volume(volume);
258 	if (vol == NULL)
259 		return ENODEV;
260 
261 	err = ubi_more_update_data(ubi, vol, buf, size);
262 	if (err < 0) {
263 		printf("Couldnt or partially wrote data\n");
264 		return -err;
265 	}
266 
267 	if (err) {
268 		size = err;
269 
270 		err = ubi_check_volume(ubi, vol->vol_id);
271 		if (err < 0)
272 			return -err;
273 
274 		if (err) {
275 			ubi_warn(ubi, "volume %d on UBI device %d is corrupt",
276 				 vol->vol_id, ubi->ubi_num);
277 			vol->corrupted = 1;
278 		}
279 
280 		vol->checked = 1;
281 		ubi_gluebi_updated(vol);
282 	}
283 
284 	return 0;
285 }
286 
ubi_volume_begin_write(char * volume,void * buf,size_t size,size_t full_size)287 int ubi_volume_begin_write(char *volume, void *buf, size_t size,
288 	size_t full_size)
289 {
290 	int err = 1;
291 	int rsvd_bytes = 0;
292 	struct ubi_volume *vol;
293 
294 	vol = ubi_find_volume(volume);
295 	if (vol == NULL)
296 		return ENODEV;
297 
298 	rsvd_bytes = vol->reserved_pebs * (ubi->leb_size - vol->data_pad);
299 	if (size > rsvd_bytes) {
300 		printf("size > volume size! Aborting!\n");
301 		return EINVAL;
302 	}
303 
304 	err = ubi_start_update(ubi, vol, full_size);
305 	if (err < 0) {
306 		printf("Cannot start volume update\n");
307 		return -err;
308 	}
309 
310 	return ubi_volume_continue_write(volume, buf, size);
311 }
312 
ubi_volume_write(char * volume,void * buf,size_t size)313 int ubi_volume_write(char *volume, void *buf, size_t size)
314 {
315 	return ubi_volume_begin_write(volume, buf, size, size);
316 }
317 
ubi_volume_read(char * volume,char * buf,size_t size)318 int ubi_volume_read(char *volume, char *buf, size_t size)
319 {
320 	int err, lnum, off, len, tbuf_size;
321 	void *tbuf;
322 	unsigned long long tmp;
323 	struct ubi_volume *vol;
324 	loff_t offp = 0;
325 	size_t len_read;
326 
327 	vol = ubi_find_volume(volume);
328 	if (vol == NULL)
329 		return ENODEV;
330 
331 	if (vol->updating) {
332 		printf("updating");
333 		return EBUSY;
334 	}
335 	if (vol->upd_marker) {
336 		printf("damaged volume, update marker is set");
337 		return EBADF;
338 	}
339 	if (offp == vol->used_bytes)
340 		return 0;
341 
342 	if (size == 0) {
343 		printf("No size specified -> Using max size (%lld)\n", vol->used_bytes);
344 		size = vol->used_bytes;
345 	}
346 
347 	printf("Read %zu bytes from volume %s to %p\n", size, volume, buf);
348 
349 	if (vol->corrupted)
350 		printf("read from corrupted volume %d", vol->vol_id);
351 	if (offp + size > vol->used_bytes)
352 		size = vol->used_bytes - offp;
353 
354 	tbuf_size = vol->usable_leb_size;
355 	if (size < tbuf_size)
356 		tbuf_size = ALIGN(size, ubi->min_io_size);
357 	tbuf = malloc_cache_aligned(tbuf_size);
358 	if (!tbuf) {
359 		printf("NO MEM\n");
360 		return ENOMEM;
361 	}
362 	len = size > tbuf_size ? tbuf_size : size;
363 
364 	tmp = offp;
365 	off = do_div(tmp, vol->usable_leb_size);
366 	lnum = tmp;
367 	len_read = size;
368 	do {
369 		if (off + len >= vol->usable_leb_size)
370 			len = vol->usable_leb_size - off;
371 
372 		err = ubi_eba_read_leb(ubi, vol, lnum, tbuf, off, len, 0);
373 		if (err) {
374 			printf("read err %x\n", err);
375 			err = -err;
376 			break;
377 		}
378 		off += len;
379 		if (off == vol->usable_leb_size) {
380 			lnum += 1;
381 			off -= vol->usable_leb_size;
382 		}
383 
384 		size -= len;
385 		offp += len;
386 
387 		memcpy(buf, tbuf, len);
388 
389 		buf += len;
390 		len = size > tbuf_size ? tbuf_size : size;
391 	} while (size);
392 
393 	if (!size)
394 		env_set_hex("filesize", len_read);
395 
396 	free(tbuf);
397 	return err;
398 }
399 
ubi_dev_scan(struct mtd_info * info,const char * vid_header_offset)400 static int ubi_dev_scan(struct mtd_info *info, const char *vid_header_offset)
401 {
402 	char ubi_mtd_param_buffer[80];
403 	int err;
404 
405 	if (!vid_header_offset)
406 		sprintf(ubi_mtd_param_buffer, "%s", info->name);
407 	else
408 		sprintf(ubi_mtd_param_buffer, "%s,%s", info->name,
409 			vid_header_offset);
410 
411 	err = ubi_mtd_param_parse(ubi_mtd_param_buffer, NULL);
412 	if (err)
413 		return -err;
414 
415 	err = ubi_init();
416 	if (err)
417 		return -err;
418 
419 	return 0;
420 }
421 
ubi_set_skip_check(char * volume,bool skip_check)422 static int ubi_set_skip_check(char *volume, bool skip_check)
423 {
424 	struct ubi_vtbl_record vtbl_rec;
425 	struct ubi_volume *vol;
426 
427 	vol = ubi_find_volume(volume);
428 	if (!vol)
429 		return ENODEV;
430 
431 	printf("%sing skip_check on volume %s\n",
432 	       skip_check ? "Sett" : "Clear", volume);
433 
434 	vtbl_rec = ubi->vtbl[vol->vol_id];
435 	if (skip_check) {
436 		vtbl_rec.flags |= UBI_VTBL_SKIP_CRC_CHECK_FLG;
437 		vol->skip_check = 1;
438 	} else {
439 		vtbl_rec.flags &= ~UBI_VTBL_SKIP_CRC_CHECK_FLG;
440 		vol->skip_check = 0;
441 	}
442 
443 	return ubi_change_vtbl_record(ubi, vol->vol_id, &vtbl_rec);
444 }
445 
ubi_detach(void)446 static int ubi_detach(void)
447 {
448 #ifdef CONFIG_CMD_UBIFS
449 	/*
450 	 * Automatically unmount UBIFS partition when user
451 	 * changes the UBI device. Otherwise the following
452 	 * UBIFS commands will crash.
453 	 */
454 	if (ubifs_is_mounted())
455 		cmd_ubifs_umount();
456 #endif
457 
458 	/*
459 	 * Call ubi_exit() before re-initializing the UBI subsystem
460 	 */
461 	if (ubi)
462 		ubi_exit();
463 
464 	ubi = NULL;
465 
466 	return 0;
467 }
468 
ubi_part(char * part_name,const char * vid_header_offset)469 int ubi_part(char *part_name, const char *vid_header_offset)
470 {
471 	struct mtd_info *mtd;
472 	int err = 0;
473 
474 	ubi_detach();
475 
476 	mtd_probe_devices();
477 	mtd = get_mtd_device_nm(part_name);
478 	if (IS_ERR(mtd)) {
479 		printf("Partition %s not found!\n", part_name);
480 		return 1;
481 	}
482 	put_mtd_device(mtd);
483 
484 	err = ubi_dev_scan(mtd, vid_header_offset);
485 	if (err) {
486 		printf("UBI init error %d\n", err);
487 		printf("Please check, if the correct MTD partition is used (size big enough?)\n");
488 		return err;
489 	}
490 
491 	ubi = ubi_devices[0];
492 
493 	return 0;
494 }
495 
do_ubi(cmd_tbl_t * cmdtp,int flag,int argc,char * const argv[])496 static int do_ubi(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
497 {
498 	int64_t size = 0;
499 	ulong addr = 0;
500 	bool skipcheck = false;
501 
502 	if (argc < 2)
503 		return CMD_RET_USAGE;
504 
505 	if (strcmp(argv[1], "detach") == 0)
506 		return ubi_detach();
507 
508 	if (strcmp(argv[1], "part") == 0) {
509 		const char *vid_header_offset = NULL;
510 
511 		/* Print current partition */
512 		if (argc == 2) {
513 			if (!ubi) {
514 				printf("Error, no UBI device selected!\n");
515 				return 1;
516 			}
517 
518 			printf("Device %d: %s, MTD partition %s\n",
519 			       ubi->ubi_num, ubi->ubi_name, ubi->mtd->name);
520 			return 0;
521 		}
522 
523 		if (argc < 3)
524 			return CMD_RET_USAGE;
525 
526 		if (argc > 3)
527 			vid_header_offset = argv[3];
528 
529 		return ubi_part(argv[2], vid_header_offset);
530 	}
531 
532 	if ((strcmp(argv[1], "part") != 0) && !ubi) {
533 		printf("Error, no UBI device selected!\n");
534 		return 1;
535 	}
536 
537 	if (strcmp(argv[1], "info") == 0) {
538 		int layout = 0;
539 		if (argc > 2 && !strncmp(argv[2], "l", 1))
540 			layout = 1;
541 		return ubi_info(layout);
542 	}
543 
544 	if (strcmp(argv[1], "check") == 0) {
545 		if (argc > 2)
546 			return ubi_check(argv[2]);
547 
548 		printf("Error, no volume name passed\n");
549 		return 1;
550 	}
551 
552 	if (strncmp(argv[1], "create", 6) == 0) {
553 		int dynamic = 1;	/* default: dynamic volume */
554 		int id = UBI_VOL_NUM_AUTO;
555 
556 		/* Use maximum available size */
557 		size = 0;
558 
559 		/* E.g., create volume with "skipcheck" bit set */
560 		if (argc == 7) {
561 			skipcheck = strncmp(argv[6], "--skipcheck", 11) == 0;
562 			argc--;
563 		}
564 
565 		/* E.g., create volume size type vol_id */
566 		if (argc == 6) {
567 			id = simple_strtoull(argv[5], NULL, 16);
568 			argc--;
569 		}
570 
571 		/* E.g., create volume size type */
572 		if (argc == 5) {
573 			if (strncmp(argv[4], "s", 1) == 0)
574 				dynamic = 0;
575 			else if (strncmp(argv[4], "d", 1) != 0) {
576 				printf("Incorrect type\n");
577 				return 1;
578 			}
579 			argc--;
580 		}
581 		/* E.g., create volume size */
582 		if (argc == 4) {
583 			if (argv[3][0] != '-')
584 				size = simple_strtoull(argv[3], NULL, 16);
585 			argc--;
586 		}
587 		/* Use maximum available size */
588 		if (!size) {
589 			size = (int64_t)ubi->avail_pebs * ubi->leb_size;
590 			printf("No size specified -> Using max size (%lld)\n", size);
591 		}
592 		/* E.g., create volume */
593 		if (argc == 3) {
594 			return ubi_create_vol(argv[2], size, dynamic, id,
595 					      skipcheck);
596 		}
597 	}
598 
599 	if (strncmp(argv[1], "remove", 6) == 0) {
600 		/* E.g., remove volume */
601 		if (argc == 3)
602 			return ubi_remove_vol(argv[2]);
603 	}
604 
605 	if (strncmp(argv[1], "skipcheck", 9) == 0) {
606 		/* E.g., change skip_check flag */
607 		if (argc == 4) {
608 			skipcheck = strncmp(argv[3], "on", 2) == 0;
609 			return ubi_set_skip_check(argv[2], skipcheck);
610 		}
611 	}
612 
613 	if (strncmp(argv[1], "write", 5) == 0) {
614 		int ret;
615 
616 		if (argc < 5) {
617 			printf("Please see usage\n");
618 			return 1;
619 		}
620 
621 		addr = simple_strtoul(argv[2], NULL, 16);
622 		size = simple_strtoul(argv[4], NULL, 16);
623 
624 		if (strlen(argv[1]) == 10 &&
625 		    strncmp(argv[1] + 5, ".part", 5) == 0) {
626 			if (argc < 6) {
627 				ret = ubi_volume_continue_write(argv[3],
628 						(void *)addr, size);
629 			} else {
630 				size_t full_size;
631 				full_size = simple_strtoul(argv[5], NULL, 16);
632 				ret = ubi_volume_begin_write(argv[3],
633 						(void *)addr, size, full_size);
634 			}
635 		} else {
636 			ret = ubi_volume_write(argv[3], (void *)addr, size);
637 		}
638 		if (!ret) {
639 			printf("%lld bytes written to volume %s\n", size,
640 			       argv[3]);
641 		}
642 
643 		return ret;
644 	}
645 
646 	if (strncmp(argv[1], "read", 4) == 0) {
647 		size = 0;
648 
649 		/* E.g., read volume size */
650 		if (argc == 5) {
651 			size = simple_strtoul(argv[4], NULL, 16);
652 			argc--;
653 		}
654 
655 		/* E.g., read volume */
656 		if (argc == 4) {
657 			addr = simple_strtoul(argv[2], NULL, 16);
658 			argc--;
659 		}
660 
661 		if (argc == 3) {
662 			return ubi_volume_read(argv[3], (char *)addr, size);
663 		}
664 	}
665 
666 	printf("Please see usage\n");
667 	return 1;
668 }
669 
670 U_BOOT_CMD(
671 	ubi, 7, 1, do_ubi,
672 	"ubi commands",
673 	"detach"
674 		" - detach ubi from a mtd partition\n"
675 	"ubi part [part] [offset]\n"
676 		" - Show or set current partition (with optional VID"
677 		" header offset)\n"
678 	"ubi info [l[ayout]]"
679 		" - Display volume and ubi layout information\n"
680 	"ubi check volumename"
681 		" - check if volumename exists\n"
682 	"ubi create[vol] volume [size] [type] [id] [--skipcheck]\n"
683 		" - create volume name with size ('-' for maximum"
684 		" available size)\n"
685 	"ubi write[vol] address volume size"
686 		" - Write volume from address with size\n"
687 	"ubi write.part address volume size [fullsize]\n"
688 		" - Write part of a volume from address\n"
689 	"ubi read[vol] address volume [size]"
690 		" - Read volume to address with size\n"
691 	"ubi remove[vol] volume"
692 		" - Remove volume\n"
693 	"ubi skipcheck volume on/off - Set or clear skip_check flag in volume header\n"
694 	"[Legends]\n"
695 	" volume: character name\n"
696 	" size: specified in bytes\n"
697 	" type: s[tatic] or d[ynamic] (default=dynamic)"
698 );
699