基于QEMU-aarch64学习UEFI(EDK2)-1环境搭建
基于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/openssl
url = https://gitee.com/rayu/openssl
[submodule "SoftFloat"]
path = ArmPkg/Library/ArmSoftFloatLib/berkeley-softfloat-3
url = https://gitee.com/rayu/berkeley-softfloat-3.git
[submodule "UnitTestFrameworkPkg/Library/CmockaLib/cmocka"]
path = UnitTestFrameworkPkg/Library/CmockaLib/cmocka
url = https://gitee.com/liuson945/edk2-cmocka.git
[submodule "MdeModulePkg/Universal/RegularExpressionDxe/oniguruma"]
path = MdeModulePkg/Universal/RegularExpressionDxe/oniguruma
url = https://gitee.com/rayu/oniguruma
[submodule "MdeModulePkg/Library/BrotliCustomDecompressLib/brotli"]
path = MdeModulePkg/Library/BrotliCustomDecompressLib/brotli
url = https://gitee.com/rayu/brotli
[submodule "BaseTools/Source/C/BrotliCompress/brotli"]
path = BaseTools/Source/C/BrotliCompress/brotli
url = https://gitee.com/rayu/brotli
ignore = untracked^M
[submodule "RedfishPkg/Library/JsonLib/jansson"]
path = RedfishPkg/Library/JsonLib/jansson
url = https://gitee.com/jiego/jansson
而我对比最新的tag，即202211版本又新增了一个子模块，名称为googletest。
在gitee上面搜索，发现有别人也同步了这个名为googletest的仓库，那么我参考修改一下，下面是最终的.gitmodules文件。
[submodule "CryptoPkg/Library/OpensslLib/openssl"]
path = CryptoPkg/Library/OpensslLib/openssl
url = https://gitee.com/rayu/openssl
[submodule "SoftFloat"]
path = ArmPkg/Library/ArmSoftFloatLib/berkeley-softfloat-3
url = https://gitee.com/rayu/berkeley-softfloat-3.git
[submodule "UnitTestFrameworkPkg/Library/CmockaLib/cmocka"]
path = UnitTestFrameworkPkg/Library/CmockaLib/cmocka
url = https://gitee.com/liuson945/edk2-cmocka.git
[submodule "MdeModulePkg/Universal/RegularExpressionDxe/oniguruma"]
path = MdeModulePkg/Universal/RegularExpressionDxe/oniguruma
url = https://gitee.com/rayu/oniguruma
[submodule "MdeModulePkg/Library/BrotliCustomDecompressLib/brotli"]
path = MdeModulePkg/Library/BrotliCustomDecompressLib/brotli
url = https://gitee.com/rayu/brotli
[submodule "BaseTools/Source/C/BrotliCompress/brotli"]
path = BaseTools/Source/C/BrotliCompress/brotli
url = https://gitee.com/rayu/brotli
ignore = untracked
[submodule "RedfishPkg/Library/JsonLib/jansson"]
path = RedfishPkg/Library/JsonLib/jansson
url = https://gitee.com/jiego/jansson
[submodule "UnitTestFrameworkPkg/Library/GoogleTestLib/googletest"]
path = UnitTestFrameworkPkg/Library/GoogleTestLib/googletest
url = 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环境已经搭建完成，后续进行程序开发学习。