如何编写自定义OpenCore UEFI驱动：从.inf到.efi的DXE驱动开发完整教程

如何编写自定义OpenCore UEFI驱动：从.inf到.efi的DXE驱动开发完整教程

【免费下载链接】OpenCorePkgOpenCore bootloader项目地址: https://gitcode.com/gh_mirrors/op/OpenCorePkg

OpenCore UEFI 驱动开发入门：本教程带你从零开始编写一个自定义 OpenCore DXE 驱动（.inf 描述文件 + C 源码），用 EDK 构建工具编译成可直接挂载到 UEFI 固件卷的 .efi 文件。OpenCore 不仅是一个开源 UEFI 引导加载器，其官方仓库 OpenCorePkg 还自带一套完整的 UEFI 驱动开发 SDK，内置数十个可复用库和现成构建脚本，是编写自定义 UEFI 驱动的最佳起点。

一、OpenCore UEFI 驱动是什么？

DXE Driver 是 UEFI 固件运行阶段加载的标准可执行模块，最终会打包进固件卷（FV）中。用 UEFITool 打开一个注入了自定义驱动的固件镜像，可以清晰看到卷里注册的各个Dxe driver条目：

OpenCore 仓库本身就是一个现成的"驱动孵化器"：

二、一个 DXE 驱动由什么组成？

以仓库中的 Staging/EnableGop/EnableGop.inf 为例，它包含三个必备部分：

1. [Defines] 区：声明模块名（BASE_NAME）、模块类型DXE_DRIVER、入口函数名ENTRY_POINT = UefiMain、唯一FILE_GUID；
2. [Sources] 区：列出所有 C/汇编源文件，例如 EnableGop.c；
3. [LibraryClasses] 区：声明依赖的库类，如BaseLib、UefiBootServicesTableLib、OcConsoleLib等。

此外，[Depex] 区可以声明驱动的运行依赖（如某个 Protocol 或 GUID 存在时才会被加载），写TRUE表示无条件加载。

三、编写入口函数：驱动的心脏

DXE 驱动必须提供一个符合 UEFI 规范的入口函数，由 EDK 的入口点库 Library/OcDriverEntryPoint/UefiDriverEntryPoint.inf 自动链接。最小骨架如下（参考 EnableGop.c 第 136-147 行）：

EFI_STATUS EFIAPI UefiMain ( IN EFI_HANDLE ImageHandle, IN EFI_SYSTEM_TABLE *SystemTable ) { // 在这里通过 gBS/gRT/gDS 访问 Boot / Runtime / Driver 服务表 return EFI_SUCCESS; }

gBS（Boot 服务）用于内存分配、注册事件、查询 Protocol；gDS（Driver 服务）允许你在驱动阶段钩子替换固件函数——EnableGop 正是靠替换GetMemorySpaceMap来为老旧显卡补上图形输出的，这是理解 UEFI 驱动能力的一个绝佳范本。

💡 新手建议：先通读 Platform/OpenNtfsDxe（文件系统驱动）和 Staging/EnableGop（函数钩子驱动）这两个不同风格的示例。

四、利用 OpenCore 内置库，少写 80% 胶水代码

OpenCorePkg 的价值在于它替你实现了大量基础设施，驱动里直接调用即可：

• 控制台与图形：OcConsoleLib（Library/OcConsoleLib/）提供OcSetupConsole()、分辨率设置、内置渲染器；
• 调试日志：OcDebugLibProtocol、OcDebugLibSerial让驱动输出带颜色的结构化日志；
• 字符串/文件/内存：OcStringLib、OcFileLib、OcMemoryLib；
• 硬件访问：OcPciIoLib、OcSmcLib、OcRtcLib等。

库类在 OpenCorePkg.dec 中注册，具体实现在 OpenCorePkg.dsc 的 LibraryClasses 映射中指定，驱动只需声明库名即可。

五、把驱动接入项目：修改 .dsc 和 .fdf

写好.inf后，需要两处登记才能被编译：

1. 加入编译清单：在 OpenCorePkg.dsc 的[Drivers.X64]区添加一行INF路径（第 344 行附近可看到Staging/EnableGop/EnableGop.inf的登记方式）；
2. 加入固件卷：OpenCorePkg.fdf 中有一段注释写得明明白白——"DXE Drivers (other .inf files for conversion to .ffs may be added here)"，把INF OpenCorePkg/你的驱动/你的驱动.inf加进去，驱动就会被转换成 FFS 文件打进固件卷，成为 UEFITool 里能看到的那个Dxe driver条目。

如果只是把驱动独立编译出来、挂载到现有固件，可以跳过 .fdf，直接用下面的构建脚本。

六、执行构建：从源码到 .efi

仓库提供了两套一键构建脚本，在 macOS/Linux 上直接运行即可（需要先按 Docs/BuildDocs.tool 配置好 EDK 环境）：

• 编译完整 OpenCore（含你加入 .dsc/.fdf 的驱动）：运行 build_oc.tool；
• 编译 DuetBoot 引导器（含 Legacy/BootPlatform/ 中的全部平台 DXE 驱动）：运行 build_duet.tool。

构建产物在Build/X64/目录下生成你的驱动.efi。

想快速验证驱动是否真的接管了图形输出？仓库自带 GOP 测试工具，运行它可以看到测试色块正确渲染——说明 UEFI 图形链路工作正常：

七、常见问题速查 🛠

八、小结

编写自定义 OpenCore UEFI 驱动只需五步：写 .inf → 写 UefiMain → 接入 .dsc/.fdf → 跑构建脚本 → 用 UEFITool 验证。借助 OpenCorePkg 内置的Oc*库和 EnableGop、OpenNtfsDxe 等参考实现，你完全可以基于本教程在一天内做出自己的第一个 DXE 驱动。下一步建议深入阅读 OpenCorePkg.dsc 中各 LibraryClass 的映射规则，以及 Docs/ 下的配置文档，掌握 OpenCore 的完整生态。

【免费下载链接】OpenCorePkgOpenCore bootloader项目地址: https://gitcode.com/gh_mirrors/op/OpenCorePkg