三亩地 三亩地SAN MU DI · CODE DIARY
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天,欢迎挑你感兴趣的翻一翻。

手把手教你编译飞腾E2000Q开发板的UEFI固件(基于EDK2,含QEMU测试)

手把手教你编译飞腾E2000Q开发板的UEFI固件(基于EDK2,含QEMU测试)

飞腾E2000Q开发板UEFI固件编译与QEMU测试全指南

在国产化硬件平台快速发展的今天,掌握底层固件定制能力成为嵌入式开发者的核心竞争力。本文将带您深入探索飞腾E2000Q开发板的UEFI固件编译全流程,从环境搭建到QEMU虚拟化测试,手把手解决国产平台特有的编译挑战。

1. 开发环境准备

编译UEFI固件前,需要配置专业的开发环境。推荐使用Ubuntu 20.04 LTS或更新版本作为基础系统,以下是必备组件清单:

  • 基础工具链:

    sudo apt update && sudo apt install -y build-essential uuid-dev iasl git gcc-aarch64-linux-gnu
  • EDK2依赖项:

    sudo apt install -y python3-distutils nasm acpica-tools
  • QEMU测试环境:

    sudo apt install -y qemu-system-arm libvirt-daemon-system virt-manager

提示:建议分配至少50GB磁盘空间和8GB内存,完整编译过程可能消耗大量系统资源。

配置交叉编译工具链时,需特别注意飞腾E2000Q采用的ARMv8架构特性。通过以下命令验证工具链兼容性:

aarch64-linux-gnu-gcc --version | grep Target # 预期输出应包含'aarch64-linux-gnu'

2. EDK2源码工程配置

EDK2作为UEFI参考实现,其模块化设计需要精准的仓库协同:

仓库名称作用描述飞腾平台关键路径
edk2核心框架与基础模块ArmPkg/ArmVirtPkg
edk2-platforms板级支持包(BSP)Platform/Phytium/CherryPkg
edk2-non-osi非开源二进制组件Silicon/Phytium/

获取源码的推荐方式:

git clone https://github.com/tianocore/edk2.git git clone --recurse-submodules https://github.com/tianocore/edk2-platforms git clone https://github.com/tianocore/edk2-non-osi

初始化编译环境时,飞腾平台需要特殊处理:

export WORKSPACE=$(pwd)/edk2 cd $WORKSPACE . edksetup.sh make -C BaseTools

3. 飞腾E2000Q固件定制编译

针对飞腾E2000Q的编译需要特别注意平台特有配置:

  1. 修改目标平台描述文件:

    vi edk2-platforms/Platform/Phytium/CherryPkg/CherryPkg.dsc

    注释掉测试模块:

    - MdeModulePkg/Universal/DriverSampleDxe/DriverSampleDxe.inf + # MdeModulePkg/Universal/DriverSampleDxe/DriverSampleDxe.inf
  2. 调整FDF闪存布局文件:

    vi edk2-platforms/Platform/Phytium/CherryPkg/CherryPkg.fdf

    同步移除对应模块引用

  3. 关键编译参数说明:

    • -a AARCH64:指定ARM64架构
    • -t GCC5:使用GCC5工具链
    • -b DEBUG:生成调试符号
    • -p Platform/Phytium/CherryPkg/CherryPkg.dsc:指定平台包

完整编译命令示例:

build -a AARCH64 -t GCC5 -b DEBUG -p Platform/Phytium/CherryPkg/CherryPkg.dsc

编译产物通常位于:

Build/Cherry-AARCH64/DEBUG_GCC5/FV/CHERRY_EFI.fd

4. QEMU虚拟化测试实战

利用QEMU进行固件验证是开发流程中的关键环节:

固件镜像预处理:

cp Build/Cherry-AARCH64/DEBUG_GCC5/FV/CHERRY_EFI.fd QEMU_EFI.fd qemu-img resize -f raw QEMU_EFI.fd 64M

启动参数配置:

qemu-system-aarch64 \ -machine virt,gic-version=3 \ -cpu cortex-a72 -smp 4 \ -m 4096M \ -drive file=QEMU_EFI.fd,if=pflash,format=raw \ -device virtio-gpu-pci \ -device usb-ehci -device usb-kbd \ -serial stdio \ -netdev user,id=net0 -device virtio-net-device,netdev=net0

注意:若遇到启动失败,可添加-d int,cpu_reset参数输出详细调试信息

典型问题排查表:

现象可能原因解决方案
卡在BDS阶段显卡驱动未初始化检查virtio-gpu配置
网络设备不可用未加载virtio-net驱动确认固件包含NetworkingPkg
内存分配失败未正确设置MEMORY_SIZE调整-d参数查看内存映射

5. 高级定制与调试技巧

深入UEFI开发需要掌握以下进阶技能:

固件界面定制:

  1. 修改启动LOGO:
    convert logo.png -depth 8 BMP3:logo.bmp cp logo.bmp MdeModulePkg/Logo/
  2. 调整界面字符串:
    vi MdeModulePkg/Application/UiApp/FrontPageStrings.uni

调试手段:

  • 串口日志输出:
    DEBUG((DEBUG_INFO, "Custom debug message\n"));
  • 内存断点设置:
    qemu-system-aarch64 -gdb tcp::1234 -S

性能优化参数:

build -p Platform/Phytium/CherryPkg/CherryPkg.dsc \ -a AARCH64 -t GCC5 -b RELEASE \ -D FD_SIZE_2MB -D FLASH_SIZE=0x200000

在实际项目中,我们发现飞腾平台对ACPI表的处理有特殊要求,建议在DSDT中额外添加以下声明:

DefinitionBlock ("", "DSDT", 2, "PHYTUM", "E2000Q ", 0x00001000) { Scope (_SB) { Device (PHY0) { Name (_HID, "PHYT0001") Name (_UID, 0) } } }

通过本指南的系统实践,开发者应能建立起完整的国产平台固件开发能力。记得定期同步上游EDK2仓库以获取安全更新,当遇到平台特有问题时,建议查阅飞腾提供的《E2000Q芯片手册》获取底层寄存器配置信息。

← 返回列表