UEFI设备路径数据库：常见设备路径示例与说明

UEFI设备路径数据库：常见设备路径示例与说明

【免费下载链接】edk2EDK II项目地址: https://gitcode.com/gh_mirrors/ed/edk2

UEFI（统一可扩展固件接口）设备路径是UEFI系统中用于标识硬件设备的标准化方法，它通过结构化的路径描述来唯一确定设备在系统中的位置。本文将详解UEFI设备路径的核心概念、常见类型及实际应用示例，帮助开发者和用户快速理解这一关键技术。

一、UEFI设备路径基础

UEFI设备路径通过EFI_DEVICE_PATH_PROTOCOL结构体实现，定义于MdePkg/Include/Protocol/DevicePath.h。每个设备路径由多个节点（Node）组成，每个节点包含：

• 类型（Type）：区分硬件、ACPI、消息传递等设备类别
• 子类型（SubType）：定义具体设备类型（如PCI、USB、SATA等）
• 长度（Length）：节点数据大小

设备路径以结束节点（End of Device Path）标识结束，结构上类似文件系统路径，但面向硬件设备定位。

二、设备路径类型与示例

2.1 硬件设备路径（Type=0x01）

2.1.1 PCI设备路径

子类型（SubType=0x01），用于标识PCI总线上的设备：

typedef struct { EFI_DEVICE_PATH_PROTOCOL Header; UINT8 Function; // 功能号 UINT8 Device; // 设备号 } PCI_DEVICE_PATH;

示例：PCI(0x01,0x00)表示PCI总线0、设备1、功能0。

2.1.2 USB设备路径

子类型（SubType=0x05），通过端口和接口号定位USB设备：

typedef struct { EFI_DEVICE_PATH_PROTOCOL Header; UINT8 ParentPortNumber; // 父端口号 UINT8 InterfaceNumber; // 接口号 } USB_DEVICE_PATH;

示例：USB(0x0,0x0)/USB(0x1,0x0)表示根 hub 端口0连接的设备，其端口1连接的子设备。

2.2 消息传递设备路径（Type=0x03）

2.2.1 SATA设备路径

子类型（SubType=0x12），用于SATA存储设备：

typedef struct { EFI_DEVICE_PATH_PROTOCOL Header; UINT16 HBAPortNumber; // HBA端口号 UINT16 PortMultiplierPortNumber; // 端口倍增器端口号 UINT16 Lun; // 逻辑单元号 } SATA_DEVICE_PATH;

示例：SATA(0x0,0xFFFF,0x0)表示直接连接到HBA端口0的LUN 0设备。

2.2.2 网络设备路径

包括MAC地址、IPv4/IPv6等子类型，例如MAC地址路径：

typedef struct { EFI_DEVICE_PATH_PROTOCOL Header; EFI_MAC_ADDRESS MacAddress; // MAC地址 UINT8 IfType; // 接口类型（如802.3） } MAC_ADDR_DEVICE_PATH;

2.3 ACPI设备路径（Type=0x02）

通过ACPI _HID（硬件ID）和_UID（唯一ID）定位设备：

typedef struct { EFI_DEVICE_PATH_PROTOCOL Header; UINT32 HID; // 硬件ID UINT32 UID; // 唯一ID } ACPI_HID_DEVICE_PATH;

示例：ACPI(PNP0A03,0x0)表示ACPI设备HID为PNP0A03（PCI根桥）。

三、设备路径的实际应用

3.1 固件卷结构与设备路径

UEFI固件通常以固件卷（FV）形式组织，设备路径可用于定位卷内文件。下图展示固件卷的层次结构：

UEFI固件卷由卷头、文件系统和多个文件组成，设备路径可精确定位卷内文件位置

3.2 设备路径树结构

设备路径可组合形成树状结构，反映系统硬件拓扑。例如：

根节点下包含多个固件卷（FV），每个FV包含文件系统（FS）和具体文件节（Section）

3.3 常见复合路径示例

• 硬盘路径：PCI(0x1,0x0)/SATA(0x0,0xFFFF,0x0)/HD(1,MBR,0x80000000,0x200000,0x200000)

  • 解析：PCI设备(1,0) → SATA端口0 → 硬盘1（MBR分区，起始扇区0x80000000）

• USB键盘路径：USB(0x0,0x0)/USB(0x1,0x0)/HID(0x1,0x0)

  • 解析：根USB端口0 → 子USB端口1 → HID设备接口0

四、设备路径工具与库

EDK2提供多个库函数简化设备路径操作：

• DevicePathLib：路径创建、解析、比较（MdePkg/Library/BaseDevicePathLib/）
• DevicePathFromText：文本格式与二进制路径互转（MdePkg/Include/Protocol/DevicePathFromText.h）

示例代码：

// 将文本路径转换为二进制设备路径 EFI_DEVICE_PATH_PROTOCOL* TextToDevicePath(CHAR16 *TextPath) { EFI_DEVICE_PATH_FROM_TEXT_PROTOCOL *DevicePathFromText; gBS->LocateProtocol(&gEfiDevicePathFromTextProtocolGuid, NULL, (VOID**)&DevicePathFromText); return DevicePathFromText->ConvertTextToDevicePath(TextPath); }

五、总结

UEFI设备路径是硬件识别的核心机制，通过标准化的节点结构实现跨平台设备定位。掌握设备路径的类型、格式及工具库，有助于开发者调试硬件驱动、优化启动流程。实际应用中，可结合EDK2提供的库函数快速处理设备路径，提升系统兼容性与可靠性。

如需深入学习，建议参考EDK2源码中MdePkg/Include/Protocol/DevicePath.h定义及相关示例。

【免费下载链接】edk2EDK II项目地址: https://gitcode.com/gh_mirrors/ed/edk2