UEFI实战EDK编译和使用（更新版）

Posted 2021-10-21 jiangwei0512

说明

之前使用的EDK版本是vUDK2018，该版本跟最新的版本比已经有很大的差异，之前的编译方式也已经不再适用，这里进行更新。

编译

1. 安装Python3.x版本并设置环境变量（这里使用了Python39，但是实际测试Python36也可以）：

测试可用（Ctrl+z + Enter退出）：

2. 安装Visual Studio 2019，需要注意选择红框中的组件（版本目前来看没有特别的要求，选择最新的即可）：

这样才能使用构建EDK需要的工具和库（库主要是编译BaseTools时需要使用）：

3. 下载源码（https://github.com/tianocore/edk2），并切换到稳定版本（最新版本可能存在一些问题，所以这里选择使用稳定版本做测试），命令如下：

git checkout edk2-stable202108

4. 执行edksetup.bat脚本，可以看到有报错：

这是因为构建EDK的工具BaseTools还没有生成，需要手动编译生成。

5. 在生成BaseTools之前还需要下载代码，这是因为BaseTool中的brotli工具源码并没有包含在当前的项目中，可以看到它是通过子模块的方式放到EDK源码中的：

每一行最前面的-表示子模块没有被检出（图中可以看到brotli在MdeModulePkg中也有使用，后续编译还需要放一份）。

正常情况下可以通过如下的命令来检出子模块：

git submodule init
git submodule update brotli

但是因为网络问题可能没法直接检出，这里可以选择直接去Github的官网下载ZIP包：

放到指定的目录：

到这里BaseTools的代码已经准备妥当，可以执行edksetup.bat Rebuild来编译BaseTool工具：

完成之后在BaseTools\\Bin\\Win32生成需要的文件：

到这里BaseTools已经生成成功，但是实际上最重要的build工具并不会生成，该工具在EDK新版本中不再使用exe版本了，而是使用Python版本，所以还需要设置一个Python相关的变量：

set PYTHON_COMMAND=py -3

这样构建的时候就会使用Python版本的build。

6. 到这里构建工具已经准备好，后面的步骤就是编译UEFI二进制，但是从前面已经看到当前的代码并不完整，还需要下载一些额外的子模块，包括MdeModulePkg中的brotli，CryptoPkg中的openssl，方法还是从Github下载ZIP包，注意openssl本身还依赖于额外的子模块，不过这里不需要使用。

7. 代码准备妥当之后就可以构建UEFI（这里选择构建OVMF）二进制了，命令如下（执行命令之前需要先执行脚本edksetup.bat）：

build -p OvmfPkg/OvmfPkgX64.dsc -a X64 -t VS2019

这里的build对应的是BaseTools\\BinPipWrappers\\WindowsLike\\build.bat：

@setlocal
@set ToolName=%~n0%
@%PYTHON_COMMAND% -m edk2basetools.%ToolName%.%ToolName% %*

构建成功，结果如下：

使用

生成的二进制Build\\OvmfX64\\DEBUG_VS2019\\FV\\OVMF.fd，可以通过QEMU启动，如下所示：

完整代码

完整可用的代码已经上传https://gitee.com/jiangwei0512/edk2-beni，可以直接下载、编译和使用，当然相关的工具比如VS2019，Python3.x等，还是需要额外的安装。