一、UEFI概述与开发环境搭建：理解UEFI与BIOS的区别，掌握EDK2环境搭建、工具链配置及第一个Hello World模块的编译运行

UEFI（统一可扩展固件接口）自Intel在2005年提出以来，已经逐步取代传统BIOS成为x86、ARM等平台固件开发的主流标准。对于固件开发者而言，理解UEFI与BIOS的本质差异，掌握EDK2（EFI Development Kit II）环境的搭建与工具链配置，是进入UEFI开发领域的第一道门槛。本章将从概念辨析、环境搭建、工具链配置到Hello World模块的编译运行，系统性地完成UEFI开发的入门闭环。

1.1 UEFI与BIOS的核心差异

1.1.1 核心原理：从实模式到保护模式的跨越

传统BIOS基于16位实模式运行，CPU在加电后直接进入实模式，寻址空间仅1MB，所有代码依赖汇编语言编写，通过中断向量表（如INT 13h磁盘服务、INT 10h显示服务）提供硬件抽象。这种设计在1980年代是合理的，但随着硬件复杂度提升，BIOS的局限性日益凸显：无法直接访问大内存、缺乏统一的驱动模型、启动流程固化且难以扩展。

UEFI从根本上改变了这一局面。UEFI固件运行在32位或64位保护模式/长模式下，CPU可以访问全部物理内存，代码使用C语言编写，通过Protocol/Handle架构实现模块间的松耦合通信。UEFI规范定义了从加电到操作系统接管前的完整启动流程，包括SEC（安全验证）、PEI（EFI前期初始化）、DXE（驱动执行环境）和BDS（启动设备选择）四个阶段。

1.1.2 对比分析：关键维度差异表

1.1.3 实战场景：为什么现代固件开发必须转向UEFI

以某国产服务器厂商为例，其原有BIOS团队需要支持2TB以上大容量NVMe磁盘启动、支持TPM 2.0安全启动、支持PXE网络部署。在传统BIOS下，这些需求几乎无法实现——MBR分区表限制磁盘容量，Option ROM机制无法加载复杂驱动，安全启动更是无从谈起。迁移到UEFI后，团队利用EDK2提供的NvmePassThru协议和Secure Boot模块，在三个月内完成了固件适配，启动时间从原来的25秒缩短至12秒，同时满足了等保三级的安全要求。

1.1.4 常见误区与总结

1.2 EDK2环境搭建与工具链配置

1.2.1 核心原理：EDK2的工程结构

EDK2是TianoCore项目维护的开源UEFI参考实现，其工程结构遵循一套严格的规范。顶层目录包含edk2/主仓库和edk2-platforms/平台仓库。主仓库中，MdePkg定义了UEFI规范的基础头文件和库，MdeModulePkg提供通用模块实现，ShellPkg包含UEFI Shell实现，OvmfPkg则用于QEMU虚拟机固件。每个包（Package）内部包含模块（Module），模块由.inf文件描述构建信息，由.c/.h文件实现功能，包级.dsc文件定义构建配置，.fdf文件定义固件镜像布局。

1.2.2 操作流程：Ubuntu 22.04下的完整搭建步骤

1. 安装依赖包：

   sudo apt update
   sudo apt install -y build-essential git uuid-dev nasm python3 python3-distutils
   # 如果使用GCC工具链，还需安装：
   sudo apt install -y gcc g++ make

2. 克隆EDK2源码：

   git clone https://github.com/tianocore/edk2.git
   cd edk2
   git submodule update --init --recursive

3. 设置环境变量：

   export EDK_TOOLS_PATH=$PWD/BaseTools
   make -C BaseTools
   source edksetup.sh

4. 配置工具链：编辑Conf/target.txt文件，设置：

   ACTIVE_PLATFORM       = OvmfPkg/OvmfPkgX64.dsc
   TARGET                = DEBUG
   TARGET_ARCH           = X64
   TOOL_CHAIN_TAG        = GCC5

5. 验证环境：执行build命令，首次构建OvmfPkg可能需要10-20分钟，成功后会在Build/OvmfX64/DEBUG_GCC5/FV/目录下生成OVMF.fd固件镜像。

1.2.3 案例拆解：工具链选择与常见问题

1.2.4 常见误区与总结

1.3 第一个Hello World模块：从源码到运行

1.3.1 核心原理：UEFI应用程序的入口与输出

UEFI应用程序（UEFI Application）是运行在UEFI环境下的可执行文件，其入口函数为UefiMain，接收两个参数：ImageHandle（镜像句柄）和SystemTable（系统表指针）。通过SystemTable->ConOut->OutputString()可以向控制台输出字符串。与标准C程序的main()不同，UEFI应用程序没有argc/argv，而是通过SystemTable访问系统服务。

1.3.2 操作流程：编写HelloWorld模块

第一步：创建模块目录

cd edk2
mkdir -p MyHelloWorldPkg/HelloWorld

第二步：编写模块描述文件（HelloWorld.inf）

[Defines]
  INF_VERSION                    = 0x00010005
  BASE_NAME                      = HelloWorld
  FILE_GUID                      = 8D0E8C7A-9B3C-4F2A-8E5D-1A2B3C4D5E6F
  MODULE_TYPE                    = UEFI_APPLICATION
  VERSION_STRING                 = 1.0
  ENTRY_POINT                    = UefiMain

[Sources]
  HelloWorld.c

[Packages]
  MdePkg/MdePkg.dec

[LibraryClasses]
  UefiApplicationEntryPoint
  UefiLib

第三步：编写C源码（HelloWorld.c）

#include <Uefi.h>
#include <Library/UefiLib.h>
#include <Library/UefiApplicationEntryPoint.h>

EFI_STATUS
EFIAPI
UefiMain (
  IN EFI_HANDLE        ImageHandle,
  IN EFI_SYSTEM_TABLE  *SystemTable
  )
{
  SystemTable->ConOut->OutputString (SystemTable->ConOut, L"Hello, UEFI World!\r\n");
  return EFI_SUCCESS;
}

第四步：创建包描述文件（MyHelloWorldPkg.dsc）

[Defines]
  PLATFORM_NAME           = MyHelloWorldPkg
  PLATFORM_GUID           = 9E2F6C8B-1D4A-4B3C-8F5E-6A7B8C9D0E1F
  PLATFORM_VERSION        = 1.0
  DSC_SPECIFICATION       = 0x00010005
  OUTPUT_DIRECTORY        = Build/MyHelloWorld
  SUPPORTED_ARCHITECTURES = X64
  BUILD_TARGETS           = DEBUG|RELEASE
  SKUID_IDENTIFIER        = DEFAULT

[Components]
  MyHelloWorldPkg/HelloWorld/HelloWorld.inf

第五步：编译构建

source edksetup.sh
build -p MyHelloWorldPkg/MyHelloWorldPkg.dsc -m MyHelloWorldPkg/HelloWorld/HelloWorld.inf -t GCC5

编译成功后，生成的HelloWorld.efi位于Build/MyHelloWorld/DEBUG_GCC5/X64/目录下。

第六步：在QEMU中运行验证

# 创建FAT格式磁盘镜像
dd if=/dev/zero of=disk.img bs=1M count=64
mkfs.vfat disk.img
# 挂载并复制efi文件
mkdir -p /mnt/uefi
sudo mount disk.img /mnt/uefi
sudo mkdir -p /mnt/uefi/EFI/BOOT
sudo cp Build/MyHelloWorld/DEBUG_GCC5/X64/HelloWorld.efi /mnt/uefi/EFI/BOOT/BOOTX64.EFI
sudo umount /mnt/uefi
# 启动QEMU
qemu-system-x86_64 -bios Build/OvmfX64/DEBUG_GCC5/FV/OVMF.fd -hda disk.img -nographic

在UEFI Shell中，输入fs0:切换到FAT分区，然后运行EFI\BOOT\BOOTX64.EFI，即可看到"Hello, UEFI World!"输出。

1.3.3 案例拆解：从HelloWorld到实际固件模块

某嵌入式设备厂商需要开发一个UEFI诊断模块，用于在固件阶段检测DDR内存故障。基于HelloWorld框架，团队扩展了以下功能：

• 内存检测：通过gBS->AllocatePages()分配测试内存，执行读写校验模式（如0xAA/0x55交替、递增地址模式）
• 日志输出：使用DEBUG((DEBUG_INFO, "Address: %p, Expected: %x, Actual: %x\r\n", addr, expected, actual))输出调试信息
• 串口通信：通过SerialIo协议将测试结果发送到外部调试终端

该模块最终集成到平台的.fdf文件中，在DXE阶段自动加载，实现了固件级的内存故障诊断能力，相比传统BIOS下的内存检测工具，检测速度提升了3倍，且无需依赖操作系统。

1.3.4 常见误区与总结