基于QEMU-aarch64学习UEFI(EDK2)-1环境搭建

文章目录

基于QEMU-aarch64学习UEFI(EDK2)-1环境搭建
- 一、环境搭建
- - 1、虚拟机Ubuntu系统安装
  - 2、docker镜像导入
  - 3、下载EDK2源码
  - 4、容器创建和代码编译
  - - 4.1 容器创建
    - 4.2 代码编译
  - 5、运行QEMU_EFI.fd
  - 6、VSCODE配置
  - 7、日常工作
  - 8、不同项目的处理方法
  - 9、submodules的处理
  - 10、Ubuntu安装软件环境

一、环境搭建

1、虚拟机Ubuntu系统安装

虚拟机安装Ubuntu系统，如20.04，安装完系统后sudo apt-get install qemu*，用于安装qemu-system-aarch64应用程序。

2、docker镜像导入

系统安装完成后，如果没有docker请手动安装，安装完成后，输入以下命令，查看docker的容器和镜像，暂时是没有任何东西的。

下面导入我们之前编译的一个docker镜像，镜像包含了EDK2编译所需的软件。

导入我们的镜像，docker load -i rayuuu-edk2.tar
或者docker pull rayuuu/edk2:v1

导入完成，docker images命令可以看到我们刚刚导入的镜像。

docker镜像导入到这里，说明我们的软件环境已经搭建完成。

3、下载EDK2源码

软件环境搭建完成，下面开始下载源码,如果github下载速度慢，建议同步仓库到gitee上面再进行下载。。

git clone https://github.com/tianocore/edk2.git

下载完成后，我们继续克隆其他的仓库，如：edk2-platforms,edk2-libc,uefi-tools等仓库，命令如下：

git clone https://github.com/tianocore/edk2.git
git clone https://github.com/tianocore/edk2-platforms.git
git clone https://github.com/tianocore/edk2-libc.git
git clone https://github.com/tianocore/edk2-non-osi.git
git clone https://git.linaro.org/uefi/uefi-tools.git

克隆完成后，我们进入edk2，同步submodule。

cd edk2
git submodule update --init

然后checkout一个稳定的分支，如edk2-stable202208。

git checkout -b edk2-rayu-202208 edk2-stable202208

4、容器创建和代码编译

4.1 容器创建

源码下载完成后，使用我们第二步导入的docker镜像，创建一个容器，开始尝试编译代码。

#docker run -h uefi --name uefistudy -p 2022:22 --privileged=true -v /work/study/uefistudy/edk2-202208:/data -it rayuuu/edk2:v1 bash
##命令解析如下：
docker run -h uefi \  #设置主机名称为uefi
--name uefistudy \  #设置容器名称为uefistudy
-p 2022:22 \  #端口映射，容器22端口映射到主机2022端口 docker不建议使用ssh，所以不用映射
端口
--privileged=true \  #使container内的root拥有真正的root权限
-v /work/study/uefistudy/edk2-202208:/data \   #数据映射，将主机work目录映射到容器data目录，可根据实际情况修改。
-it rayuuu/edk2:v1 bash

输入以上命令后，发现成功进入容器。

进入容器/data目录，查看我们映射的文件，已经存在。

4.2 代码编译

容器创建完成，下面开始编译QEMU，我们通过uefi-tools，首先配置uefi-tools工具。

编辑uefi-tools/edk2-build.sh，添加对应的路径。

然后使用该命令编译。

# armvirtqemu64是platforms名字
./uefi-tools/edk2-build.sh armvirtqemu64  -b DEBUG

提示没有权限。

输入命令sudo chmod a+rw /data，然后重新编译。

./uefi-tools/edk2-build.sh -b DEBUG armvirtqemu64

编译还是报错，退出，删掉容器，重新创建一个容器，以root用户登录。

docker run -h uefi --name uefistudy -p 2022:22 --privileged=true -uroot -v /work/study/uefistudy/edk2-202208:/home/edk2/src -it rayuuu/edk2:v1 bash

映射到/home/edk2/src路径，以root用户登录，重新编译，可以通过。

git status如果出现大量的修改，而且提示：

$ git diff code.c

old mode 100644

new mode 100755

那么使用命令：git config core.filemode false修改，此命令只针对当前仓库有效。

5、运行QEMU_EFI.fd

编译通过后，我们在Ubuntu系统下使用QEMU加载uefi固件。

在docker容器内，固件路径是/home/edk2/src/Build/ArmVirtQemu-AARCH64/DEBUG_GCC5/FV/QEMU_EFI.fd，那么在Ubuntu系统下的路径为/work/study/uefistudy/edk2-202208/Build/ArmVirtQemu-AARCH64/DEBUG_GCC5/FV/QEMU_EFI.fd

#qemu命令
qemu-system-aarch64 -machine virt,kernel_irqchip=on,gic-version=3 -cpu cortex-a57 -m 1G  \-device virtio-gpu-pci \-drive file=fat:rw:./filedir/,media=disk,if=virtio,format=raw -nodefaults  -device qemu-xhci -device usb-kbd \-bios `pwd`/Build/ArmVirtQemu-AARCH64/DEBUG_GCC5/FV/QEMU_EFI.fd \-serial stdio

上面命令使用qemu-system-aarch64程序，加载固件，将filedir文件夹映射到qemu中，实现文件共享。

我们使用上面命令运行我们刚刚编译的QEMU_EFI.fd，效果如下。

其中fs0:就是我们的filedir文件夹。

我们输入fs0:可以进入filedir查看文件。

其与我们在Ubuntu实际看到的文件一致。

6、VSCODE配置

我们这里以VSCODE为例，编辑代码，当然你也可以用vscode或者sublime代替。

这里推荐一个扩展，名字叫做edk2-vscode，对比sourceinsight可以实现FDF、DSC、DEC等文件跳转。

如果像*.dsc.inc，*.fdf.inc等文件无法识别的话，可以自己在"设置"->“文件”->"文件关联"中设置如下图：

将要识别的文件后缀名对应edk2_dsc，edk2_fdf。

这样查看代码就会自动变色了。

7、日常工作

参考：韦东山——《嵌入式Linux应用开发完全手册V3.0_韦东山全系列视频文档-IMX6ULL开发板.docx》

假设你已经创建了容器，那么在日常工作中，你每天打开电脑后，你需要做的就是这个命令：

docker  start ubuntu     # 启动ubuntu容器
docker exec  -it ubuntu  bash # 进入容器，开始工作，可以在多个命令行中执行这命令
#在Ubuntu下，要先执行start 命令，它会启动SSH、NFS等服务
#在Ubuntu下，执行exit退出容器
docker  stop  ubuntu     # 停止容器，下班回家

我们查看我们创建的容器，docker ps -a命令。

我们这里可以重新命名，把CONTAINER ID自定义命名。

docker rename 8b7cf92dbd2d edk2

所以后续，我们每天开机就是docker start edk2来启动容器，然后进入容器编译。

8、不同项目的处理方法

针对不同的项目，也可以创建不同的容器，映射对应的代码文件夹即可，比如我们有一个project2的项目名称，那么我们新建一个project2的文件夹，把代码解压至project2中。

然后同步远程仓库，

git checkout master
git pull origin master

这时我们想同步最新的edk2-stable202211版本，发现没有同步到本地。

我们使用命令git fetch --tags -f，把远程tag同步过来。

接着创建远程tag edk2-stable202211为本地分支edk2-rayu-202211。

命令如下：git checkout -b edk2-rayu-202211 edk2-stable202211

git log命令查看已经通过到最新的tag。

这样我们project2项目同步了最新的edk2-stable202211版本，我们下面创建project2的容器。

命令同之前创建容器一样，只是代码路径和端口不同：

docker run -h project2 --name project2 -p 2023:22 --privileged=true -uroot -v /work/study/project2/edk2-202211:/home/edk2/src -it rayuuu/edk2:v1 bash

进入容器，同样的编译方式，可以看到编译无问题。

9、submodules的处理

因为edk2里面包含了一些子模块，需要同步才能编译，上面演示是我已经把子模块下载完成了，同步到新的tag，我们需要再更新一次子模块。

由于网络原因，我把github的仓库导入到了gitee上面进行下载到本地，速度会快很多，下面是我的.gitmodules文件参考：

[submodule "CryptoPkg/Library/OpensslLib/openssl"]path = CryptoPkg/Library/OpensslLib/opensslurl = https://gitee.com/rayu/openssl[submodule "SoftFloat"]path = ArmPkg/Library/ArmSoftFloatLib/berkeley-softfloat-3url = https://gitee.com/rayu/berkeley-softfloat-3.git[submodule "UnitTestFrameworkPkg/Library/CmockaLib/cmocka"]path = UnitTestFrameworkPkg/Library/CmockaLib/cmockaurl = https://gitee.com/liuson945/edk2-cmocka.git[submodule "MdeModulePkg/Universal/RegularExpressionDxe/oniguruma"]path = MdeModulePkg/Universal/RegularExpressionDxe/onigurumaurl = https://gitee.com/rayu/oniguruma[submodule "MdeModulePkg/Library/BrotliCustomDecompressLib/brotli"]path = MdeModulePkg/Library/BrotliCustomDecompressLib/brotliurl = https://gitee.com/rayu/brotli[submodule "BaseTools/Source/C/BrotliCompress/brotli"]path = BaseTools/Source/C/BrotliCompress/brotliurl = https://gitee.com/rayu/brotliignore = untracked^M[submodule "RedfishPkg/Library/JsonLib/jansson"]path = RedfishPkg/Library/JsonLib/janssonurl = https://gitee.com/jiego/jansson

而我对比最新的tag，即202211版本又新增了一个子模块，名称为googletest。

在gitee上面搜索，发现有别人也同步了这个名为googletest的仓库，那么我参考修改一下，下面是最终的.gitmodules文件。

[submodule "CryptoPkg/Library/OpensslLib/openssl"]path = CryptoPkg/Library/OpensslLib/opensslurl = https://gitee.com/rayu/openssl
[submodule "SoftFloat"]path = ArmPkg/Library/ArmSoftFloatLib/berkeley-softfloat-3url = https://gitee.com/rayu/berkeley-softfloat-3.git
[submodule "UnitTestFrameworkPkg/Library/CmockaLib/cmocka"]path = UnitTestFrameworkPkg/Library/CmockaLib/cmockaurl = https://gitee.com/liuson945/edk2-cmocka.git
[submodule "MdeModulePkg/Universal/RegularExpressionDxe/oniguruma"]path = MdeModulePkg/Universal/RegularExpressionDxe/onigurumaurl = https://gitee.com/rayu/oniguruma
[submodule "MdeModulePkg/Library/BrotliCustomDecompressLib/brotli"]path = MdeModulePkg/Library/BrotliCustomDecompressLib/brotliurl = https://gitee.com/rayu/brotli
[submodule "BaseTools/Source/C/BrotliCompress/brotli"]path = BaseTools/Source/C/BrotliCompress/brotliurl = https://gitee.com/rayu/brotliignore = untracked
[submodule "RedfishPkg/Library/JsonLib/jansson"]path = RedfishPkg/Library/JsonLib/janssonurl = https://gitee.com/jiego/jansson[submodule "UnitTestFrameworkPkg/Library/GoogleTestLib/googletest"]path = UnitTestFrameworkPkg/Library/GoogleTestLib/googletesturl = https://gitee.com/zqx5449/googletest.git

然后更新子模块，命令git submodule update --init

10、Ubuntu安装软件环境

如果不想使用docker导入镜像的方式编译软件，那么可以在Ubuntu系统里面安装官方参考，使用apt-get命令安装。

比如：

sudo apt-get install -y bison build-essential uuid-dev iasl git gcc-5 nasm python3-distutils gcc-aarch64-linux-gnu

至此，我们在docker下编译EDK2环境已经搭建完成，后续进行程序开发学习。