1 /* 2 * Copyright (C) 2016 Google, Inc 3 * Written by Simon Glass <sjg@chromium.org> 4 * 5 * SPDX-License-Identifier: GPL-2.0+ 6 */ 7 8 #include <common.h> 9 #include <blk.h> 10 #include <dm.h> 11 #include <dm/device-internal.h> 12 #include <dm/lists.h> 13 #include <dm/uclass-internal.h> 14 15 static const char *if_typename_str[IF_TYPE_COUNT] = { 16 [IF_TYPE_IDE] = "ide", 17 [IF_TYPE_SCSI] = "scsi", 18 [IF_TYPE_ATAPI] = "atapi", 19 [IF_TYPE_USB] = "usb", 20 [IF_TYPE_DOC] = "doc", 21 [IF_TYPE_MMC] = "mmc", 22 [IF_TYPE_SD] = "sd", 23 [IF_TYPE_SATA] = "sata", 24 [IF_TYPE_HOST] = "host", 25 [IF_TYPE_SYSTEMACE] = "ace", 26 [IF_TYPE_NVME] = "nvme", 27 [IF_TYPE_RKNAND] = "rknand", 28 [IF_TYPE_SPINAND] = "spinand", 29 [IF_TYPE_SPINOR] = "spinor", 30 [IF_TYPE_RAMDISK] = "ramdisk", 31 [IF_TYPE_MTD] = "mtd", 32 }; 33 34 static enum uclass_id if_type_uclass_id[IF_TYPE_COUNT] = { 35 [IF_TYPE_IDE] = UCLASS_IDE, 36 [IF_TYPE_SCSI] = UCLASS_SCSI, 37 [IF_TYPE_ATAPI] = UCLASS_INVALID, 38 [IF_TYPE_USB] = UCLASS_MASS_STORAGE, 39 [IF_TYPE_DOC] = UCLASS_INVALID, 40 [IF_TYPE_MMC] = UCLASS_MMC, 41 [IF_TYPE_SD] = UCLASS_INVALID, 42 [IF_TYPE_SATA] = UCLASS_AHCI, 43 [IF_TYPE_HOST] = UCLASS_ROOT, 44 [IF_TYPE_NVME] = UCLASS_NVME, 45 [IF_TYPE_RKNAND] = UCLASS_RKNAND, 46 [IF_TYPE_SPINAND] = UCLASS_SPI_FLASH, 47 [IF_TYPE_SPINOR] = UCLASS_SPI_FLASH, 48 [IF_TYPE_RAMDISK] = UCLASS_RAMDISK, 49 [IF_TYPE_MTD] = UCLASS_MTD, 50 [IF_TYPE_SYSTEMACE] = UCLASS_INVALID, 51 }; 52 53 enum if_type if_typename_to_iftype(const char *if_typename) 54 { 55 int i; 56 57 for (i = 0; i < IF_TYPE_COUNT; i++) { 58 if (if_typename_str[i] && 59 !strcmp(if_typename, if_typename_str[i])) 60 return i; 61 } 62 63 return IF_TYPE_UNKNOWN; 64 } 65 66 static enum uclass_id if_type_to_uclass_id(enum if_type if_type) 67 { 68 return if_type_uclass_id[if_type]; 69 } 70 71 const char *blk_get_if_type_name(enum if_type if_type) 72 { 73 return if_typename_str[if_type]; 74 } 75 76 struct blk_desc *blk_get_devnum_by_type(enum if_type if_type, int devnum) 77 { 78 struct blk_desc *desc; 79 struct udevice *dev; 80 int ret; 81 82 ret = blk_get_device(if_type, devnum, &dev); 83 if (ret) 84 return NULL; 85 desc = dev_get_uclass_platdata(dev); 86 87 return desc; 88 } 89 90 /* 91 * This function is complicated with driver model. We look up the interface 92 * name in a local table. This gives us an interface type which we can match 93 * against the uclass of the block device's parent. 94 */ 95 struct blk_desc *blk_get_devnum_by_typename(const char *if_typename, int devnum) 96 { 97 enum uclass_id uclass_id; 98 enum if_type if_type; 99 struct udevice *dev; 100 struct uclass *uc; 101 int ret; 102 103 if_type = if_typename_to_iftype(if_typename); 104 if (if_type == IF_TYPE_UNKNOWN) { 105 debug("%s: Unknown interface type '%s'\n", __func__, 106 if_typename); 107 return NULL; 108 } 109 uclass_id = if_type_to_uclass_id(if_type); 110 if (uclass_id == UCLASS_INVALID) { 111 debug("%s: Unknown uclass for interface type'\n", 112 if_typename_str[if_type]); 113 return NULL; 114 } 115 116 ret = uclass_get(UCLASS_BLK, &uc); 117 if (ret) 118 return NULL; 119 uclass_foreach_dev(dev, uc) { 120 struct blk_desc *desc = dev_get_uclass_platdata(dev); 121 122 debug("%s: if_type=%d, devnum=%d: %s, %d, %d\n", __func__, 123 if_type, devnum, dev->name, desc->if_type, desc->devnum); 124 if (desc->devnum != devnum) 125 continue; 126 127 /* Find out the parent device uclass */ 128 if (device_get_uclass_id(dev->parent) != uclass_id) { 129 #ifdef CONFIG_MTD_BLK 130 /* 131 * The normal mtd block attachment steps are 132 * UCLASS_BLK -> UCLASS_MTD -> UCLASS_(SPI or NAND). 133 * Since the spi flash frame is attached to 134 * UCLASS_SPI_FLASH, this make mistake to find 135 * the UCLASS_MTD when find the mtd block device. 136 * Fix it here when enable CONFIG_MTD_BLK. 137 */ 138 if (device_get_uclass_id(dev->parent) == UCLASS_SPI_FLASH && 139 if_type == IF_TYPE_MTD && 140 devnum == BLK_MTD_SPI_NOR) { 141 debug("Fix the spi flash uclass different\n"); 142 } else { 143 debug("%s: parent uclass %d, this dev %d\n", 144 __func__, 145 device_get_uclass_id(dev->parent), 146 uclass_id); 147 continue; 148 } 149 #else 150 debug("%s: parent uclass %d, this dev %d\n", __func__, 151 device_get_uclass_id(dev->parent), uclass_id); 152 continue; 153 #endif 154 } 155 156 if (device_probe(dev)) 157 return NULL; 158 159 debug("%s: Device desc %p\n", __func__, desc); 160 return desc; 161 } 162 debug("%s: No device found\n", __func__); 163 164 return NULL; 165 } 166 167 /** 168 * get_desc() - Get the block device descriptor for the given device number 169 * 170 * @if_type: Interface type 171 * @devnum: Device number (0 = first) 172 * @descp: Returns block device descriptor on success 173 * @return 0 on success, -ENODEV if there is no such device and no device 174 * with a higher device number, -ENOENT if there is no such device but there 175 * is one with a higher number, or other -ve on other error. 176 */ 177 static int get_desc(enum if_type if_type, int devnum, struct blk_desc **descp) 178 { 179 bool found_more = false; 180 struct udevice *dev; 181 struct uclass *uc; 182 int ret; 183 184 *descp = NULL; 185 ret = uclass_get(UCLASS_BLK, &uc); 186 if (ret) 187 return ret; 188 uclass_foreach_dev(dev, uc) { 189 struct blk_desc *desc = dev_get_uclass_platdata(dev); 190 191 debug("%s: if_type=%d, devnum=%d: %s, %d, %d\n", __func__, 192 if_type, devnum, dev->name, desc->if_type, desc->devnum); 193 if (desc->if_type == if_type) { 194 if (desc->devnum == devnum) { 195 ret = device_probe(dev); 196 if (ret) 197 return ret; 198 199 *descp = desc; 200 return 0; 201 } else if (desc->devnum > devnum) { 202 found_more = true; 203 } 204 } 205 } 206 207 return found_more ? -ENOENT : -ENODEV; 208 } 209 210 int blk_select_hwpart_devnum(enum if_type if_type, int devnum, int hwpart) 211 { 212 struct udevice *dev; 213 int ret; 214 215 ret = blk_get_device(if_type, devnum, &dev); 216 if (ret) 217 return ret; 218 219 return blk_select_hwpart(dev, hwpart); 220 } 221 222 int blk_list_part(enum if_type if_type) 223 { 224 struct blk_desc *desc; 225 int devnum, ok; 226 int ret; 227 228 for (ok = 0, devnum = 0;; ++devnum) { 229 ret = get_desc(if_type, devnum, &desc); 230 if (ret == -ENODEV) 231 break; 232 else if (ret) 233 continue; 234 if (desc->part_type != PART_TYPE_UNKNOWN) { 235 ++ok; 236 if (devnum) 237 putc('\n'); 238 part_print(desc); 239 } 240 } 241 if (!ok) 242 return -ENODEV; 243 244 return 0; 245 } 246 247 int blk_print_part_devnum(enum if_type if_type, int devnum) 248 { 249 struct blk_desc *desc; 250 int ret; 251 252 ret = get_desc(if_type, devnum, &desc); 253 if (ret) 254 return ret; 255 if (desc->type == DEV_TYPE_UNKNOWN) 256 return -ENOENT; 257 part_print(desc); 258 259 return 0; 260 } 261 262 void blk_list_devices(enum if_type if_type) 263 { 264 struct blk_desc *desc; 265 int ret; 266 int i; 267 268 for (i = 0;; ++i) { 269 ret = get_desc(if_type, i, &desc); 270 if (ret == -ENODEV) 271 break; 272 else if (ret) 273 continue; 274 if (desc->type == DEV_TYPE_UNKNOWN) 275 continue; /* list only known devices */ 276 printf("Device %d: ", i); 277 dev_print(desc); 278 } 279 } 280 281 int blk_print_device_num(enum if_type if_type, int devnum) 282 { 283 struct blk_desc *desc; 284 int ret; 285 286 ret = get_desc(if_type, devnum, &desc); 287 if (ret) 288 return ret; 289 printf("\nIDE device %d: ", devnum); 290 dev_print(desc); 291 292 return 0; 293 } 294 295 int blk_show_device(enum if_type if_type, int devnum) 296 { 297 struct blk_desc *desc; 298 int ret; 299 300 printf("\nDevice %d: ", devnum); 301 ret = get_desc(if_type, devnum, &desc); 302 if (ret == -ENODEV || ret == -ENOENT) { 303 printf("unknown device\n"); 304 return -ENODEV; 305 } 306 if (ret) 307 return ret; 308 dev_print(desc); 309 310 if (desc->type == DEV_TYPE_UNKNOWN) 311 return -ENOENT; 312 313 return 0; 314 } 315 316 ulong blk_read_devnum(enum if_type if_type, int devnum, lbaint_t start, 317 lbaint_t blkcnt, void *buffer) 318 { 319 struct blk_desc *desc; 320 ulong n; 321 int ret; 322 323 ret = get_desc(if_type, devnum, &desc); 324 if (ret) 325 return ret; 326 n = blk_dread(desc, start, blkcnt, buffer); 327 if (IS_ERR_VALUE(n)) 328 return n; 329 330 return n; 331 } 332 333 ulong blk_write_devnum(enum if_type if_type, int devnum, lbaint_t start, 334 lbaint_t blkcnt, const void *buffer) 335 { 336 struct blk_desc *desc; 337 int ret; 338 339 ret = get_desc(if_type, devnum, &desc); 340 if (ret) 341 return ret; 342 return blk_dwrite(desc, start, blkcnt, buffer); 343 } 344 345 ulong blk_write_zeroes_devnum(enum if_type if_type, int devnum, lbaint_t start, 346 lbaint_t blkcnt) 347 { 348 struct blk_desc *desc; 349 int ret; 350 351 ret = get_desc(if_type, devnum, &desc); 352 if (ret) 353 return ret; 354 return blk_dwrite_zeroes(desc, start, blkcnt); 355 } 356 357 ulong blk_erase_devnum(enum if_type if_type, int devnum, lbaint_t start, 358 lbaint_t blkcnt) 359 { 360 struct blk_desc *desc; 361 int ret; 362 363 ret = get_desc(if_type, devnum, &desc); 364 if (ret) 365 return ret; 366 return blk_derase(desc, start, blkcnt); 367 } 368 369 int blk_select_hwpart(struct udevice *dev, int hwpart) 370 { 371 const struct blk_ops *ops = blk_get_ops(dev); 372 373 if (!ops) 374 return -ENOSYS; 375 if (!ops->select_hwpart) 376 return 0; 377 378 return ops->select_hwpart(dev, hwpart); 379 } 380 381 int blk_dselect_hwpart(struct blk_desc *desc, int hwpart) 382 { 383 return blk_select_hwpart(desc->bdev, hwpart); 384 } 385 386 int blk_first_device(int if_type, struct udevice **devp) 387 { 388 struct blk_desc *desc; 389 int ret; 390 391 ret = uclass_find_first_device(UCLASS_BLK, devp); 392 if (ret) 393 return ret; 394 if (!*devp) 395 return -ENODEV; 396 do { 397 desc = dev_get_uclass_platdata(*devp); 398 if (desc->if_type == if_type) 399 return 0; 400 ret = uclass_find_next_device(devp); 401 if (ret) 402 return ret; 403 } while (*devp); 404 405 return -ENODEV; 406 } 407 408 int blk_next_device(struct udevice **devp) 409 { 410 struct blk_desc *desc; 411 int ret, if_type; 412 413 desc = dev_get_uclass_platdata(*devp); 414 if_type = desc->if_type; 415 do { 416 ret = uclass_find_next_device(devp); 417 if (ret) 418 return ret; 419 if (!*devp) 420 return -ENODEV; 421 desc = dev_get_uclass_platdata(*devp); 422 if (desc->if_type == if_type) 423 return 0; 424 } while (1); 425 } 426 427 int blk_find_device(int if_type, int devnum, struct udevice **devp) 428 { 429 struct uclass *uc; 430 struct udevice *dev; 431 int ret; 432 433 ret = uclass_get(UCLASS_BLK, &uc); 434 if (ret) 435 return ret; 436 uclass_foreach_dev(dev, uc) { 437 struct blk_desc *desc = dev_get_uclass_platdata(dev); 438 439 debug("%s: if_type=%d, devnum=%d: %s, %d, %d\n", __func__, 440 if_type, devnum, dev->name, desc->if_type, desc->devnum); 441 if (desc->if_type == if_type && desc->devnum == devnum) { 442 *devp = dev; 443 return 0; 444 } 445 } 446 447 return -ENODEV; 448 } 449 450 int blk_get_device(int if_type, int devnum, struct udevice **devp) 451 { 452 int ret; 453 454 ret = blk_find_device(if_type, devnum, devp); 455 if (ret) 456 return ret; 457 458 return device_probe(*devp); 459 } 460 461 unsigned long blk_dread(struct blk_desc *block_dev, lbaint_t start, 462 lbaint_t blkcnt, void *buffer) 463 { 464 struct udevice *dev = block_dev->bdev; 465 const struct blk_ops *ops = blk_get_ops(dev); 466 ulong blks_read; 467 468 if (!ops->read) 469 return -ENOSYS; 470 471 if (blkcache_read(block_dev->if_type, block_dev->devnum, 472 start, blkcnt, block_dev->blksz, buffer)) 473 return blkcnt; 474 blks_read = ops->read(dev, start, blkcnt, buffer); 475 if (blks_read == blkcnt) 476 blkcache_fill(block_dev->if_type, block_dev->devnum, 477 start, blkcnt, block_dev->blksz, buffer); 478 479 return blks_read; 480 } 481 482 unsigned long blk_dwrite(struct blk_desc *block_dev, lbaint_t start, 483 lbaint_t blkcnt, const void *buffer) 484 { 485 struct udevice *dev = block_dev->bdev; 486 const struct blk_ops *ops = blk_get_ops(dev); 487 488 if (!ops->write) 489 return -ENOSYS; 490 491 blkcache_invalidate(block_dev->if_type, block_dev->devnum); 492 return ops->write(dev, start, blkcnt, buffer); 493 } 494 495 unsigned long blk_dwrite_zeroes(struct blk_desc *block_dev, lbaint_t start, 496 lbaint_t blkcnt) 497 { 498 struct udevice *dev = block_dev->bdev; 499 const struct blk_ops *ops = blk_get_ops(dev); 500 501 if (!ops->write_zeroes) 502 return -ENOSYS; 503 504 blkcache_invalidate(block_dev->if_type, block_dev->devnum); 505 return ops->write_zeroes(dev, start, blkcnt); 506 } 507 508 unsigned long blk_derase(struct blk_desc *block_dev, lbaint_t start, 509 lbaint_t blkcnt) 510 { 511 struct udevice *dev = block_dev->bdev; 512 const struct blk_ops *ops = blk_get_ops(dev); 513 514 if (!ops->erase) 515 return -ENOSYS; 516 517 blkcache_invalidate(block_dev->if_type, block_dev->devnum); 518 return ops->erase(dev, start, blkcnt); 519 } 520 521 int blk_prepare_device(struct udevice *dev) 522 { 523 struct blk_desc *desc = dev_get_uclass_platdata(dev); 524 525 part_init(desc); 526 527 return 0; 528 } 529 530 int blk_get_from_parent(struct udevice *parent, struct udevice **devp) 531 { 532 struct udevice *dev; 533 enum uclass_id id; 534 int ret; 535 536 device_find_first_child(parent, &dev); 537 if (!dev) { 538 debug("%s: No block device found for parent '%s'\n", __func__, 539 parent->name); 540 return -ENODEV; 541 } 542 id = device_get_uclass_id(dev); 543 if (id != UCLASS_BLK) { 544 debug("%s: Incorrect uclass %s for block device '%s'\n", 545 __func__, uclass_get_name(id), dev->name); 546 return -ENOTBLK; 547 } 548 ret = device_probe(dev); 549 if (ret) 550 return ret; 551 *devp = dev; 552 553 return 0; 554 } 555 556 int blk_find_max_devnum(enum if_type if_type) 557 { 558 struct udevice *dev; 559 int max_devnum = -ENODEV; 560 struct uclass *uc; 561 int ret; 562 563 ret = uclass_get(UCLASS_BLK, &uc); 564 if (ret) 565 return ret; 566 uclass_foreach_dev(dev, uc) { 567 struct blk_desc *desc = dev_get_uclass_platdata(dev); 568 569 if (desc->if_type == if_type && desc->devnum > max_devnum) 570 max_devnum = desc->devnum; 571 } 572 573 return max_devnum; 574 } 575 576 static int blk_next_free_devnum(enum if_type if_type) 577 { 578 int ret; 579 580 ret = blk_find_max_devnum(if_type); 581 if (ret == -ENODEV) 582 return 0; 583 if (ret < 0) 584 return ret; 585 586 return ret + 1; 587 } 588 589 static int blk_claim_devnum(enum if_type if_type, int devnum) 590 { 591 struct udevice *dev; 592 struct uclass *uc; 593 int ret; 594 595 ret = uclass_get(UCLASS_BLK, &uc); 596 if (ret) 597 return ret; 598 uclass_foreach_dev(dev, uc) { 599 struct blk_desc *desc = dev_get_uclass_platdata(dev); 600 601 if (desc->if_type == if_type && desc->devnum == devnum) { 602 int next = blk_next_free_devnum(if_type); 603 604 if (next < 0) 605 return next; 606 #ifdef CONFIG_USING_KERNEL_DTB_V2 607 /* 608 * Not allow devnum to be forced distributed. 609 * See commit (e48eeb9ea3 dm: blk: Improve block device claiming). 610 * 611 * fix like: "Device 'dwmmc@fe2b0000': seq 0 is in use by 'sdhci@fe310000'" 612 */ 613 if (!(gd->flags & GD_FLG_KDTB_READY)) 614 #endif 615 desc->devnum = next; 616 617 return 0; 618 } 619 } 620 621 return -ENOENT; 622 } 623 624 int blk_create_device(struct udevice *parent, const char *drv_name, 625 const char *name, int if_type, int devnum, int blksz, 626 lbaint_t size, struct udevice **devp) 627 { 628 struct blk_desc *desc; 629 struct udevice *dev; 630 int ret; 631 632 if (devnum == -1) { 633 devnum = blk_next_free_devnum(if_type); 634 } else { 635 ret = blk_claim_devnum(if_type, devnum); 636 if (ret < 0 && ret != -ENOENT) 637 return ret; 638 } 639 if (devnum < 0) 640 return devnum; 641 ret = device_bind_driver(parent, drv_name, name, &dev); 642 if (ret) 643 return ret; 644 desc = dev_get_uclass_platdata(dev); 645 desc->if_type = if_type; 646 desc->blksz = blksz; 647 desc->rawblksz = blksz; 648 desc->lba = size / blksz; 649 desc->rawlba = size / blksz; 650 desc->part_type = PART_TYPE_UNKNOWN; 651 desc->bdev = dev; 652 desc->devnum = devnum; 653 *devp = dev; 654 655 return 0; 656 } 657 658 int blk_create_devicef(struct udevice *parent, const char *drv_name, 659 const char *name, int if_type, int devnum, int blksz, 660 lbaint_t size, struct udevice **devp) 661 { 662 char dev_name[30], *str; 663 int ret; 664 665 snprintf(dev_name, sizeof(dev_name), "%s.%s", parent->name, name); 666 str = strdup(dev_name); 667 if (!str) 668 return -ENOMEM; 669 670 ret = blk_create_device(parent, drv_name, str, if_type, devnum, 671 blksz, size, devp); 672 if (ret) { 673 free(str); 674 return ret; 675 } 676 device_set_name_alloced(*devp); 677 678 return 0; 679 } 680 681 int blk_unbind_all(int if_type) 682 { 683 struct uclass *uc; 684 struct udevice *dev, *next; 685 int ret; 686 687 ret = uclass_get(UCLASS_BLK, &uc); 688 if (ret) 689 return ret; 690 uclass_foreach_dev_safe(dev, next, uc) { 691 struct blk_desc *desc = dev_get_uclass_platdata(dev); 692 693 if (desc->if_type == if_type) { 694 ret = device_remove(dev, DM_REMOVE_NORMAL); 695 if (ret) 696 return ret; 697 ret = device_unbind(dev); 698 if (ret) 699 return ret; 700 } 701 } 702 703 return 0; 704 } 705 706 UCLASS_DRIVER(blk) = { 707 .id = UCLASS_BLK, 708 .name = "blk", 709 .per_device_platdata_auto_alloc_size = sizeof(struct blk_desc), 710 }; 711