UEFI开发实战指南 – 从环境搭建到国产平台适配

1. UEFI开发环境搭建全攻略第一次接触UEFI开发时我被各种陌生的术语搞得晕头转向。经过几个实际项目的摸爬滚打终于摸清了门道。UEFI开发环境的搭建其实就像搭积木只要掌握关键步骤新手也能快速上手。在Windows系统下搭建环境我推荐使用Visual Studio配合EDK2。先安装VS2015或更高版本然后从EDK2官网下载最新代码。解压后需要特别注意设置工作空间这个步骤坑过不少新手。我习惯在edk2目录下创建Conf文件夹把target.txt、tools_def.txt这些配置文件都放进去。记得把BASE_TOOLS_PATH设置正确否则后续编译会报各种找不到工具链的错误。Linux环境下更简单些直接用apt-get或yum安装gcc、make这些基础工具就行。不过要注意32位和64位库的兼容性问题我曾经因为漏装ia32-libs导致编译失败。建议运行sudo dpkg --add-architecture i386后再安装相关库。调试环境搭建是另一个重头戏。我强烈推荐使用QEMU模拟器它支持GDB调试可以设置断点、单步执行。配置QEMU时要注意启用调试端口我常用的命令是qemu-system-x86_64 -bios OVMF.fd -hda fat:rw:~/uefi_disk -net none -serial stdio -s -S。这样启动后用GDB连接1234端口就能开始调试了。2. 图形界面开发实战技巧在UEFI下做图形开发刚开始确实有点不适应。传统BIOS那种简陋的文本界面突然变成了支持各种图形特效的现代界面开发方式也完全不同。最基本的图形操作是画点和画线。UEFI提供了GOPGraphics Output Protocol协议通过它我们能获取帧缓冲区地址。我封装了几个常用函数EFI_STATUS DrawPixel(IN EFI_GRAPHICS_OUTPUT_PROTOCOL *Gop, IN UINTN X, IN UINTN Y, IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL *Color) { EFI_GRAPHICS_OUTPUT_BLT_PIXEL *Pixel; Pixel (EFI_GRAPHICS_OUTPUT_BLT_PIXEL*)Gop-Mode-FrameBufferBase; Pixel Y * Gop-Mode-Info-PixelsPerScanLine X; Pixel-Blue Color-Blue; Pixel-Green Color-Green; Pixel-Red Color-Red; return EFI_SUCCESS; }汉字显示是个技术难点。我试过几种方案最后发现点阵字库最稳定。先从Windows系统提取simsun.ttc字库然后用工具转换成二进制点阵数据。显示时要注意双字节编码问题我写了个转换函数处理GBK到Unicode的映射。移植开源GUI框架能省不少事。GuiLite是个不错的选择代码量小但功能齐全。移植时要重写底层绘图函数把原来的SDL调用替换成GOP操作。记得处理消息循环UEFI下要用WaitForEvent代替传统的消息泵。3. 外设访问与驱动开发访问PCI设备是硬件开发的必修课。UEFI提供了PCI IO Protocol通过它能枚举总线上的所有设备。我常用的设备发现流程是这样的用LocateProtocol获取PCI IO实例调用PciIo-GetLocation获取设备位置通过PciIo-Pci.Read读取配置空间解析VendorID和DeviceID确认设备类型开发UEFI驱动要注意区分DXE阶段和RT阶段。DXE驱动在启动早期加载能访问所有服务RT驱动在运行时工作功能受限。我建议新手先从简单的应用型驱动入手比如给特定设备添加控制接口。USB设备开发更复杂些。除了标准的USB Protocol还要处理各种描述符。我调试USB HID设备时发现描述符错一个字节都会导致枚举失败。建议先用USB分析仪抓包确认描述符格式正确再写代码。4. 国产平台适配经验分享在龙芯平台做移植时遇到的第一个坑是字节序问题。龙芯用的是MIPS架构属于大端模式而x86是小端。处理网络数据时要特别小心我写了个宏来处理字节序转换#define SWAP16(x) (((x) 8) | ((x) 8)) #define SWAP32(x) (((x) 24) | (((x) 8) 0xFF00) | (((x) 8) 0xFF0000) | ((x) 24))飞腾平台的问题在于文档不全。很多寄存器定义要反汇编参考代码才能搞清楚。建议先研究厂商提供的SDK包里面通常有现成的驱动示例。我调试网卡驱动时就是参考了SDK里的初始化流程。交叉编译环境搭建也有讲究。龙芯需要用专门的工具链飞腾则可以用标准的aarch64工具链。我习惯在Docker里配置编译环境这样不会污染主机系统。编译EDK2时要正确设置-D ARCH参数龙芯是MIPS64飞腾是AARCH64。调试国产平台最痛苦的是缺少仿真器。我后来发现用QEMU模拟是最经济的方案。龙芯可以用qemu-system-mips64飞腾用qemu-system-aarch64。虽然不能完全模拟真实硬件但测试基础功能足够了。