1 // SPDX-License-Identifier: GPL-2.0+
3 * EFI device path from u-boot device-model mapping
5 * (C) Copyright 2017 Rob Clark
8 #define LOG_CATEGORY LOGL_ERR
15 #include <efi_loader.h>
18 /* template END node: */
19 static const struct efi_device_path END = {
20 .type = DEVICE_PATH_TYPE_END,
21 .sub_type = DEVICE_PATH_SUB_TYPE_END,
22 .length = sizeof(END),
25 /* template ROOT node: */
26 static const struct efi_device_path_vendor ROOT = {
28 .type = DEVICE_PATH_TYPE_HARDWARE_DEVICE,
29 .sub_type = DEVICE_PATH_SUB_TYPE_VENDOR,
30 .length = sizeof(ROOT),
35 #if defined(CONFIG_DM_MMC) && defined(CONFIG_MMC)
37 * Determine if an MMC device is an SD card.
39 * @desc block device descriptor
40 * @return true if the device is an SD card
42 static bool is_sd(struct blk_desc *desc)
44 struct mmc *mmc = find_mmc_device(desc->devnum);
49 return IS_SD(mmc) != 0U;
53 static void *dp_alloc(size_t sz)
57 if (efi_allocate_pool(EFI_ALLOCATE_ANY_PAGES, sz, &buf) !=
59 debug("EFI: ERROR: out of memory in %s\n", __func__);
68 * Iterate to next block in device-path, terminating (returning NULL)
71 struct efi_device_path *efi_dp_next(const struct efi_device_path *dp)
75 if (dp->type == DEVICE_PATH_TYPE_END)
77 dp = ((void *)dp) + dp->length;
78 if (dp->type == DEVICE_PATH_TYPE_END)
80 return (struct efi_device_path *)dp;
84 * Compare two device-paths, stopping when the shorter of the two hits
85 * an End* node. This is useful to, for example, compare a device-path
86 * representing a device with one representing a file on the device, or
87 * a device with a parent device.
89 int efi_dp_match(const struct efi_device_path *a,
90 const struct efi_device_path *b)
95 ret = memcmp(&a->length, &b->length, sizeof(a->length));
99 ret = memcmp(a, b, a->length);
112 * See UEFI spec (section 3.1.2, about short-form device-paths..
113 * tl;dr: we can have a device-path that starts with a USB WWID
114 * or USB Class node, and a few other cases which don't encode
115 * the full device path with bus hierarchy:
117 * - MESSAGING:USB_WWID
118 * - MESSAGING:USB_CLASS
123 static struct efi_device_path *shorten_path(struct efi_device_path *dp)
127 * TODO: Add MESSAGING:USB_WWID and MESSAGING:URI..
128 * in practice fallback.efi just uses MEDIA:HARD_DRIVE
129 * so not sure when we would see these other cases.
131 if (EFI_DP_TYPE(dp, MESSAGING_DEVICE, MSG_USB_CLASS) ||
132 EFI_DP_TYPE(dp, MEDIA_DEVICE, HARD_DRIVE_PATH) ||
133 EFI_DP_TYPE(dp, MEDIA_DEVICE, FILE_PATH))
136 dp = efi_dp_next(dp);
142 static struct efi_object *find_obj(struct efi_device_path *dp, bool short_path,
143 struct efi_device_path **rem)
145 struct efi_object *efiobj;
146 efi_uintn_t dp_size = efi_dp_instance_size(dp);
148 list_for_each_entry(efiobj, &efi_obj_list, link) {
149 struct efi_handler *handler;
150 struct efi_device_path *obj_dp;
153 ret = efi_search_protocol(efiobj->handle,
154 &efi_guid_device_path, &handler);
155 if (ret != EFI_SUCCESS)
157 obj_dp = handler->protocol_interface;
160 if (efi_dp_match(dp, obj_dp) == 0) {
163 * Allow partial matches, but inform
166 *rem = ((void *)dp) +
167 efi_dp_instance_size(obj_dp);
170 /* Only return on exact matches */
171 if (efi_dp_instance_size(obj_dp) ==
177 obj_dp = shorten_path(efi_dp_next(obj_dp));
178 } while (short_path && obj_dp);
185 * Find an efiobj from device-path, if 'rem' is not NULL, returns the
186 * remaining part of the device path after the matched object.
188 struct efi_object *efi_dp_find_obj(struct efi_device_path *dp,
189 struct efi_device_path **rem)
191 struct efi_object *efiobj;
193 /* Search for an exact match first */
194 efiobj = find_obj(dp, false, NULL);
196 /* Then for a fuzzy match */
198 efiobj = find_obj(dp, false, rem);
200 /* And now for a fuzzy short match */
202 efiobj = find_obj(dp, true, rem);
208 * Determine the last device path node that is not the end node.
211 * @return last node before the end node if it exists
214 const struct efi_device_path *efi_dp_last_node(const struct efi_device_path *dp)
216 struct efi_device_path *ret;
218 if (!dp || dp->type == DEVICE_PATH_TYPE_END)
221 ret = (struct efi_device_path *)dp;
222 dp = efi_dp_next(dp);
227 /* get size of the first device path instance excluding end node */
228 efi_uintn_t efi_dp_instance_size(const struct efi_device_path *dp)
232 if (!dp || dp->type == DEVICE_PATH_TYPE_END)
236 dp = efi_dp_next(dp);
242 /* get size of multi-instance device path excluding end node */
243 efi_uintn_t efi_dp_size(const struct efi_device_path *dp)
245 const struct efi_device_path *p = dp;
249 while (p->type != DEVICE_PATH_TYPE_END ||
250 p->sub_type != DEVICE_PATH_SUB_TYPE_END)
251 p = (void *)p + p->length;
253 return (void *)p - (void *)dp;
256 /* copy multi-instance device path */
257 struct efi_device_path *efi_dp_dup(const struct efi_device_path *dp)
259 struct efi_device_path *ndp;
260 size_t sz = efi_dp_size(dp) + sizeof(END);
273 struct efi_device_path *efi_dp_append(const struct efi_device_path *dp1,
274 const struct efi_device_path *dp2)
276 struct efi_device_path *ret;
279 /* return an end node */
280 ret = efi_dp_dup(&END);
282 ret = efi_dp_dup(dp2);
284 ret = efi_dp_dup(dp1);
286 /* both dp1 and dp2 are non-null */
287 unsigned sz1 = efi_dp_size(dp1);
288 unsigned sz2 = efi_dp_size(dp2);
289 void *p = dp_alloc(sz1 + sz2 + sizeof(END));
293 /* the end node of the second device path has to be retained */
294 memcpy(p + sz1, dp2, sz2 + sizeof(END));
301 struct efi_device_path *efi_dp_append_node(const struct efi_device_path *dp,
302 const struct efi_device_path *node)
304 struct efi_device_path *ret;
307 ret = efi_dp_dup(&END);
309 ret = efi_dp_dup(dp);
311 size_t sz = node->length;
312 void *p = dp_alloc(sz + sizeof(END));
316 memcpy(p + sz, &END, sizeof(END));
319 /* both dp and node are non-null */
320 size_t sz = efi_dp_size(dp);
321 void *p = dp_alloc(sz + node->length + sizeof(END));
325 memcpy(p + sz, node, node->length);
326 memcpy(p + sz + node->length, &END, sizeof(END));
333 struct efi_device_path *efi_dp_create_device_node(const u8 type,
337 struct efi_device_path *ret;
339 ret = dp_alloc(length);
343 ret->sub_type = sub_type;
344 ret->length = length;
348 struct efi_device_path *efi_dp_append_instance(
349 const struct efi_device_path *dp,
350 const struct efi_device_path *dpi)
353 struct efi_device_path *p, *ret;
358 return efi_dp_dup(dpi);
359 sz = efi_dp_size(dp);
360 szi = efi_dp_instance_size(dpi);
361 p = dp_alloc(sz + szi + 2 * sizeof(END));
365 memcpy(p, dp, sz + sizeof(END));
367 p->sub_type = DEVICE_PATH_SUB_TYPE_INSTANCE_END;
368 p = (void *)p + sizeof(END);
371 memcpy(p, &END, sizeof(END));
375 struct efi_device_path *efi_dp_get_next_instance(struct efi_device_path **dp,
379 struct efi_device_path *p;
385 sz = efi_dp_instance_size(*dp);
386 p = dp_alloc(sz + sizeof(END));
389 memcpy(p, *dp, sz + sizeof(END));
390 *dp = (void *)*dp + sz;
391 if ((*dp)->sub_type == DEVICE_PATH_SUB_TYPE_INSTANCE_END)
392 *dp = (void *)*dp + sizeof(END);
396 *size = sz + sizeof(END);
400 bool efi_dp_is_multi_instance(const struct efi_device_path *dp)
402 const struct efi_device_path *p = dp;
406 while (p->type != DEVICE_PATH_TYPE_END)
407 p = (void *)p + p->length;
408 return p->sub_type == DEVICE_PATH_SUB_TYPE_INSTANCE_END;
412 /* size of device-path not including END node for device and all parents
413 * up to the root device.
415 static unsigned dp_size(struct udevice *dev)
417 if (!dev || !dev->driver)
420 switch (dev->driver->id) {
422 case UCLASS_SIMPLE_BUS:
423 /* stop traversing parents at this point: */
426 return dp_size(dev->parent) +
427 sizeof(struct efi_device_path_mac_addr);
430 switch (dev->parent->uclass->uc_drv->id) {
433 return dp_size(dev->parent) +
434 sizeof(struct efi_device_path_atapi);
436 #if defined(CONFIG_SCSI) && defined(CONFIG_DM_SCSI)
438 return dp_size(dev->parent) +
439 sizeof(struct efi_device_path_scsi);
441 #if defined(CONFIG_DM_MMC) && defined(CONFIG_MMC)
443 return dp_size(dev->parent) +
444 sizeof(struct efi_device_path_sd_mmc_path);
447 return dp_size(dev->parent);
450 #if defined(CONFIG_DM_MMC) && defined(CONFIG_MMC)
452 return dp_size(dev->parent) +
453 sizeof(struct efi_device_path_sd_mmc_path);
455 case UCLASS_MASS_STORAGE:
457 return dp_size(dev->parent) +
458 sizeof(struct efi_device_path_usb_class);
460 /* just skip over unknown classes: */
461 return dp_size(dev->parent);
466 * Recursively build a device path.
468 * @buf pointer to the end of the device path
470 * @return pointer to the end of the device path
472 static void *dp_fill(void *buf, struct udevice *dev)
474 if (!dev || !dev->driver)
477 switch (dev->driver->id) {
479 case UCLASS_SIMPLE_BUS: {
480 /* stop traversing parents at this point: */
481 struct efi_device_path_vendor *vdp = buf;
487 struct efi_device_path_mac_addr *dp =
488 dp_fill(buf, dev->parent);
489 struct eth_pdata *pdata = dev->platdata;
491 dp->dp.type = DEVICE_PATH_TYPE_MESSAGING_DEVICE;
492 dp->dp.sub_type = DEVICE_PATH_SUB_TYPE_MSG_MAC_ADDR;
493 dp->dp.length = sizeof(*dp);
494 memset(&dp->mac, 0, sizeof(dp->mac));
495 /* We only support IPv4 */
496 memcpy(&dp->mac, &pdata->enetaddr, ARP_HLEN);
504 switch (dev->parent->uclass->uc_drv->id) {
507 struct efi_device_path_atapi *dp =
508 dp_fill(buf, dev->parent);
509 struct blk_desc *desc = dev_get_uclass_platdata(dev);
511 dp->dp.type = DEVICE_PATH_TYPE_MESSAGING_DEVICE;
512 dp->dp.sub_type = DEVICE_PATH_SUB_TYPE_MSG_ATAPI;
513 dp->dp.length = sizeof(*dp);
514 dp->logical_unit_number = desc->devnum;
515 dp->primary_secondary = IDE_BUS(desc->devnum);
516 dp->slave_master = desc->devnum %
517 (CONFIG_SYS_IDE_MAXDEVICE /
518 CONFIG_SYS_IDE_MAXBUS);
522 #if defined(CONFIG_SCSI) && defined(CONFIG_DM_SCSI)
524 struct efi_device_path_scsi *dp =
525 dp_fill(buf, dev->parent);
526 struct blk_desc *desc = dev_get_uclass_platdata(dev);
528 dp->dp.type = DEVICE_PATH_TYPE_MESSAGING_DEVICE;
529 dp->dp.sub_type = DEVICE_PATH_SUB_TYPE_MSG_SCSI;
530 dp->dp.length = sizeof(*dp);
531 dp->logical_unit_number = desc->lun;
532 dp->target_id = desc->target;
536 #if defined(CONFIG_DM_MMC) && defined(CONFIG_MMC)
538 struct efi_device_path_sd_mmc_path *sddp =
539 dp_fill(buf, dev->parent);
540 struct blk_desc *desc = dev_get_uclass_platdata(dev);
542 sddp->dp.type = DEVICE_PATH_TYPE_MESSAGING_DEVICE;
543 sddp->dp.sub_type = is_sd(desc) ?
544 DEVICE_PATH_SUB_TYPE_MSG_SD :
545 DEVICE_PATH_SUB_TYPE_MSG_MMC;
546 sddp->dp.length = sizeof(*sddp);
547 sddp->slot_number = dev->seq;
552 debug("%s(%u) %s: unhandled parent class: %s (%u)\n",
553 __FILE__, __LINE__, __func__,
554 dev->name, dev->parent->uclass->uc_drv->id);
555 return dp_fill(buf, dev->parent);
558 #if defined(CONFIG_DM_MMC) && defined(CONFIG_MMC)
560 struct efi_device_path_sd_mmc_path *sddp =
561 dp_fill(buf, dev->parent);
562 struct mmc *mmc = mmc_get_mmc_dev(dev);
563 struct blk_desc *desc = mmc_get_blk_desc(mmc);
565 sddp->dp.type = DEVICE_PATH_TYPE_MESSAGING_DEVICE;
566 sddp->dp.sub_type = is_sd(desc) ?
567 DEVICE_PATH_SUB_TYPE_MSG_SD :
568 DEVICE_PATH_SUB_TYPE_MSG_MMC;
569 sddp->dp.length = sizeof(*sddp);
570 sddp->slot_number = dev->seq;
575 case UCLASS_MASS_STORAGE:
576 case UCLASS_USB_HUB: {
577 struct efi_device_path_usb_class *udp =
578 dp_fill(buf, dev->parent);
579 struct usb_device *udev = dev_get_parent_priv(dev);
580 struct usb_device_descriptor *desc = &udev->descriptor;
582 udp->dp.type = DEVICE_PATH_TYPE_MESSAGING_DEVICE;
583 udp->dp.sub_type = DEVICE_PATH_SUB_TYPE_MSG_USB_CLASS;
584 udp->dp.length = sizeof(*udp);
585 udp->vendor_id = desc->idVendor;
586 udp->product_id = desc->idProduct;
587 udp->device_class = desc->bDeviceClass;
588 udp->device_subclass = desc->bDeviceSubClass;
589 udp->device_protocol = desc->bDeviceProtocol;
594 debug("%s(%u) %s: unhandled device class: %s (%u)\n",
595 __FILE__, __LINE__, __func__,
596 dev->name, dev->driver->id);
597 return dp_fill(buf, dev->parent);
601 /* Construct a device-path from a device: */
602 struct efi_device_path *efi_dp_from_dev(struct udevice *dev)
606 start = buf = dp_alloc(dp_size(dev) + sizeof(END));
609 buf = dp_fill(buf, dev);
610 *((struct efi_device_path *)buf) = END;
616 static unsigned dp_part_size(struct blk_desc *desc, int part)
623 int ret = blk_find_device(desc->if_type, desc->devnum, &dev);
626 dev = desc->bdev->parent;
627 dpsize = dp_size(dev);
630 dpsize = sizeof(ROOT) + sizeof(struct efi_device_path_usb);
633 if (part == 0) /* the actual disk, not a partition */
636 if (desc->part_type == PART_TYPE_ISO)
637 dpsize += sizeof(struct efi_device_path_cdrom_path);
639 dpsize += sizeof(struct efi_device_path_hard_drive_path);
645 * Create a device node for a block device partition.
647 * @buf buffer to which the device path is wirtten
648 * @desc block device descriptor
649 * @part partition number, 0 identifies a block device
651 static void *dp_part_node(void *buf, struct blk_desc *desc, int part)
653 disk_partition_t info;
655 part_get_info(desc, part, &info);
657 if (desc->part_type == PART_TYPE_ISO) {
658 struct efi_device_path_cdrom_path *cddp = buf;
660 cddp->boot_entry = part;
661 cddp->dp.type = DEVICE_PATH_TYPE_MEDIA_DEVICE;
662 cddp->dp.sub_type = DEVICE_PATH_SUB_TYPE_CDROM_PATH;
663 cddp->dp.length = sizeof(*cddp);
664 cddp->partition_start = info.start;
665 cddp->partition_end = info.size;
669 struct efi_device_path_hard_drive_path *hddp = buf;
671 hddp->dp.type = DEVICE_PATH_TYPE_MEDIA_DEVICE;
672 hddp->dp.sub_type = DEVICE_PATH_SUB_TYPE_HARD_DRIVE_PATH;
673 hddp->dp.length = sizeof(*hddp);
674 hddp->partition_number = part;
675 hddp->partition_start = info.start;
676 hddp->partition_end = info.size;
677 if (desc->part_type == PART_TYPE_EFI)
678 hddp->partmap_type = 2;
680 hddp->partmap_type = 1;
682 switch (desc->sig_type) {
685 hddp->signature_type = 0;
686 memset(hddp->partition_signature, 0,
687 sizeof(hddp->partition_signature));
690 hddp->signature_type = 1;
691 memset(hddp->partition_signature, 0,
692 sizeof(hddp->partition_signature));
693 memcpy(hddp->partition_signature, &desc->mbr_sig,
694 sizeof(desc->mbr_sig));
697 hddp->signature_type = 2;
698 memcpy(hddp->partition_signature, &desc->guid_sig,
699 sizeof(hddp->partition_signature));
710 * Create a device path for a block device or one of its partitions.
712 * @buf buffer to which the device path is wirtten
713 * @desc block device descriptor
714 * @part partition number, 0 identifies a block device
716 static void *dp_part_fill(void *buf, struct blk_desc *desc, int part)
721 int ret = blk_find_device(desc->if_type, desc->devnum, &dev);
724 dev = desc->bdev->parent;
725 buf = dp_fill(buf, dev);
729 * We *could* make a more accurate path, by looking at if_type
730 * and handling all the different cases like we do for non-
731 * legacy (ie CONFIG_BLK=y) case. But most important thing
732 * is just to have a unique device-path for if_type+devnum.
733 * So map things to a fictitious USB device.
735 struct efi_device_path_usb *udp;
737 memcpy(buf, &ROOT, sizeof(ROOT));
741 udp->dp.type = DEVICE_PATH_TYPE_MESSAGING_DEVICE;
742 udp->dp.sub_type = DEVICE_PATH_SUB_TYPE_MSG_USB;
743 udp->dp.length = sizeof(*udp);
744 udp->parent_port_number = desc->if_type;
745 udp->usb_interface = desc->devnum;
749 if (part == 0) /* the actual disk, not a partition */
752 return dp_part_node(buf, desc, part);
755 /* Construct a device-path from a partition on a blk device: */
756 struct efi_device_path *efi_dp_from_part(struct blk_desc *desc, int part)
760 start = buf = dp_alloc(dp_part_size(desc, part) + sizeof(END));
764 buf = dp_part_fill(buf, desc, part);
766 *((struct efi_device_path *)buf) = END;
772 * Create a device node for a block device partition.
774 * @buf buffer to which the device path is wirtten
775 * @desc block device descriptor
776 * @part partition number, 0 identifies a block device
778 struct efi_device_path *efi_dp_part_node(struct blk_desc *desc, int part)
783 if (desc->part_type == PART_TYPE_ISO)
784 dpsize = sizeof(struct efi_device_path_cdrom_path);
786 dpsize = sizeof(struct efi_device_path_hard_drive_path);
787 buf = dp_alloc(dpsize);
789 dp_part_node(buf, desc, part);
794 /* convert path to an UEFI style path (ie. DOS style backslashes and utf16) */
795 static void path_to_uefi(u16 *uefi, const char *path)
807 * If desc is NULL, this creates a path with only the file component,
808 * otherwise it creates a full path with both device and file components
810 struct efi_device_path *efi_dp_from_file(struct blk_desc *desc, int part,
813 struct efi_device_path_file_path *fp;
815 unsigned dpsize = 0, fpsize;
818 dpsize = dp_part_size(desc, part);
820 fpsize = sizeof(struct efi_device_path) + 2 * (strlen(path) + 1);
823 start = buf = dp_alloc(dpsize + sizeof(END));
828 buf = dp_part_fill(buf, desc, part);
832 fp->dp.type = DEVICE_PATH_TYPE_MEDIA_DEVICE;
833 fp->dp.sub_type = DEVICE_PATH_SUB_TYPE_FILE_PATH;
834 fp->dp.length = fpsize;
835 path_to_uefi(fp->str, path);
838 *((struct efi_device_path *)buf) = END;
844 struct efi_device_path *efi_dp_from_eth(void)
846 #ifndef CONFIG_DM_ETH
847 struct efi_device_path_mac_addr *ndp;
852 assert(eth_get_dev());
855 dpsize += dp_size(eth_get_dev());
857 dpsize += sizeof(ROOT);
858 dpsize += sizeof(*ndp);
861 start = buf = dp_alloc(dpsize + sizeof(END));
866 buf = dp_fill(buf, eth_get_dev());
868 memcpy(buf, &ROOT, sizeof(ROOT));
872 ndp->dp.type = DEVICE_PATH_TYPE_MESSAGING_DEVICE;
873 ndp->dp.sub_type = DEVICE_PATH_SUB_TYPE_MSG_MAC_ADDR;
874 ndp->dp.length = sizeof(*ndp);
875 ndp->if_type = 1; /* Ethernet */
876 memcpy(ndp->mac.addr, eth_get_ethaddr(), ARP_HLEN);
880 *((struct efi_device_path *)buf) = END;
886 /* Construct a device-path for memory-mapped image */
887 struct efi_device_path *efi_dp_from_mem(uint32_t memory_type,
888 uint64_t start_address,
889 uint64_t end_address)
891 struct efi_device_path_memory *mdp;
894 start = buf = dp_alloc(sizeof(*mdp) + sizeof(END));
899 mdp->dp.type = DEVICE_PATH_TYPE_HARDWARE_DEVICE;
900 mdp->dp.sub_type = DEVICE_PATH_SUB_TYPE_MEMORY;
901 mdp->dp.length = sizeof(*mdp);
902 mdp->memory_type = memory_type;
903 mdp->start_address = start_address;
904 mdp->end_address = end_address;
907 *((struct efi_device_path *)buf) = END;
913 * Helper to split a full device path (containing both device and file
914 * parts) into it's constituent parts.
916 efi_status_t efi_dp_split_file_path(struct efi_device_path *full_path,
917 struct efi_device_path **device_path,
918 struct efi_device_path **file_path)
920 struct efi_device_path *p, *dp, *fp;
924 dp = efi_dp_dup(full_path);
926 return EFI_OUT_OF_RESOURCES;
928 while (!EFI_DP_TYPE(p, MEDIA_DEVICE, FILE_PATH)) {
931 return EFI_OUT_OF_RESOURCES;
935 return EFI_OUT_OF_RESOURCES;
936 p->type = DEVICE_PATH_TYPE_END;
937 p->sub_type = DEVICE_PATH_SUB_TYPE_END;
938 p->length = sizeof(*p);