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

比眉伴天荒 2023-10-02 10:48 8阅读 0赞

## 说明 ##

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

## 编译 ##

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

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center]

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

![在这里插入图片描述][58b4ba70cb5f4191a34bdd3118a9ff3b.png_pic_center]

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

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 1]

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

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 2]

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 3]

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

git checkout edk2-stable202108

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

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 4]

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

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

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 5]

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

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

git submodule init
    git submodule update brotli

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

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 6]

放到指定的目录：

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 7]

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

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 8]

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

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 9]

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

set PYTHON_COMMAND=py -3

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

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

构建成功，结果如下：

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 10]

## 使用 ##

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

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 11]

## 完整代码 ##

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

[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center]: https://img-blog.csdnimg.cn/deee22d673664c318f8ce0e1e388e46a.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBAamlhbmd3ZWkwNTEy,size_20,color_FFFFFF,t_70,g_se,x_16#pic_center
[58b4ba70cb5f4191a34bdd3118a9ff3b.png_pic_center]: https://img-blog.csdnimg.cn/58b4ba70cb5f4191a34bdd3118a9ff3b.png#pic_center
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 1]: https://img-blog.csdnimg.cn/bd241906dc654ec2b80661d9383d2152.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBAamlhbmd3ZWkwNTEy,size_20,color_FFFFFF,t_70,g_se,x_16#pic_center
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 2]: https://img-blog.csdnimg.cn/a30037a0dbd4414e9fbc1cd661c48b05.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBAamlhbmd3ZWkwNTEy,size_20,color_FFFFFF,t_70,g_se,x_16#pic_center
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 3]: https://img-blog.csdnimg.cn/a3d1220145964a71b5fc91988c11266c.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBAamlhbmd3ZWkwNTEy,size_20,color_FFFFFF,t_70,g_se,x_16#pic_center
[https_github.com_tianocore_edk2]: https://github.com/tianocore/edk2
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 4]: https://img-blog.csdnimg.cn/bdad409c1d364ecba877176427b17bd5.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBAamlhbmd3ZWkwNTEy,size_20,color_FFFFFF,t_70,g_se,x_16#pic_center
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 5]: https://img-blog.csdnimg.cn/522cd943ab8a464eba65d4a1b10681a2.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBAamlhbmd3ZWkwNTEy,size_20,color_FFFFFF,t_70,g_se,x_16#pic_center
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 6]: https://img-blog.csdnimg.cn/aebda5796ba9419f836be9a04b66d491.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBAamlhbmd3ZWkwNTEy,size_20,color_FFFFFF,t_70,g_se,x_16#pic_center
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 7]: https://img-blog.csdnimg.cn/051d0fbc95e84832881c2652703191e6.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBAamlhbmd3ZWkwNTEy,size_20,color_FFFFFF,t_70,g_se,x_16#pic_center
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 8]: https://img-blog.csdnimg.cn/57ad45b6d01c44d5ac45e72999435f63.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBAamlhbmd3ZWkwNTEy,size_20,color_FFFFFF,t_70,g_se,x_16#pic_center
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 9]: https://img-blog.csdnimg.cn/b247dffc0b6648c1865f7e8124560ad6.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBAamlhbmd3ZWkwNTEy,size_20,color_FFFFFF,t_70,g_se,x_16#pic_center
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 10]: https://img-blog.csdnimg.cn/d691b5d2281744b2bddfe0f8d1289722.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBAamlhbmd3ZWkwNTEy,size_20,color_FFFFFF,t_70,g_se,x_16#pic_center
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 11]: https://img-blog.csdnimg.cn/ac78506f56ed4fc5beaa410b30e602af.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBAamlhbmd3ZWkwNTEy,size_20,color_FFFFFF,t_70,g_se,x_16#pic_center
[https_gitee.com_jiangwei0512_edk2-beni]: https://gitee.com/jiangwei0512/edk2-beni