UEFITool 0.28 固件分析工具完全使用指南

项目概述

UEFITool 0.28 是一款跨平台的C++/Qt程序，专门用于解析、提取和修改UEFI固件映像。它支持从闪存描述符开始的完整BIOS映像解析，以及包含UEFI卷的任何二进制文件。

项目目录结构详解

核心模块目录

• UEFIPatch/ - 固件补丁管理模块，支持对固件进行定制化修改
• UEFIReplace/ - 固件模块替换功能，提供安全高效的替换操作
• LZMA/ - LZMA压缩算法库，处理固件中的压缩数据
• Tiano/ - Tiano压缩支持模块，兼容多种固件格式

核心源码文件

• ffsengine.cpp - 固件文件系统解析核心引擎
• peimage.cpp - PE映像处理模块，负责可执行文件解析
• descriptor.cpp - 描述符分析工具，处理固件描述信息
• treeitem.cpp - 树状结构数据项实现
• treemodel.cpp - 树状结构数据模型管理

环境准备与安装

系统要求

项目采用Qt框架开发，需要以下环境：

• C++编译器（GCC或Clang）
• Qt 4.x或Qt 5.x库
• 支持Linux、macOS和Windows系统

快速构建指南

项目提供了自动化构建脚本unixbuild.sh，支持一键编译：

chmod +x unixbuild.sh
./unixbuild.sh

该脚本会自动检测当前操作系统平台，下载必要的Qt静态库，并完成所有工具的编译打包。

工具功能详解

UEFITool主程序

UEFITool是核心分析工具，提供完整的固件映像解析功能。程序窗口分为三个主要面板：

结构面板 - 以树状结构展示固件映像的组织架构 信息面板 - 显示选中元素的详细信息 消息面板 - 显示引擎消息、结构警告和搜索结果

UEFIPatch补丁工具

专门用于固件补丁管理，支持对固件进行安全修改。包含预定义的补丁配置文件：

• patches.txt - 主要补丁配置
• patches-misc.txt - 杂项补丁配置

UEFIReplace替换工具

提供固件模块的安全替换功能，支持热更新操作。

基本操作指南

文件打开与解析

程序可以直接启动，也可以通过命令行参数指定要打开的UEFI映像文件路径。支持解析包含UEFI卷的任何二进制文件。

元素操作功能

在树状结构的每个元素上都可以右键打开菜单，查看可用的操作：

提取操作

• 原样提取 - 提取包含头部的完整元素
• 提取主体 - 仅提取元素数据部分

替换操作

• 原样替换 - 替换包含头部的完整元素
• 替换主体 - 仅替换元素数据部分

插入操作

• 之前插入 - 在选中元素前插入新元素
• 之后插入 - 在选中元素后插入新元素
• 插入到内部 - 仅适用于UEFI卷和封装段

搜索功能

通过文件菜单中的搜索功能，可以搜索所有树元素：

• 十六进制模式搜索（空格忽略，点号作为占位符）
• GUID搜索（规则与十六进制相同）
• 文本搜索（Unicode或ASCII，支持大小写敏感设置）

搜索结果会添加到消息面板中，双击消息可以选中对应的元素。

高级功能说明

重建与修改

移除 - 标记元素在映像重建时删除 重建 - 标记元素在映像重建时重新构建

默认情况下，所有未标记重建的元素在重建过程中都不会改变。如果需要纠正某些结构错误（如无效数据校验和），必须手动标记元素进行重建。

映像重建

完成修改后，需要通过文件菜单中的保存映像文件命令启动映像重建。如果重建过程中出现问题，会弹出错误提示；否则程序会询问是否打开重建后的文件。

注意事项与限制

已知问题

• 某些映像中TE映像基地址计算非标准，修改后可能重定位不正确
• 由于尚未实现FIT表支持，某些映像修改后可能无法正常工作
• 程序设计用于处理BIOS映像，而非特定供应商的BIOS更新文件

安全提示

固件修改存在风险，建议在测试环境中操作，并始终备份原始文件。

技术文档资源

• 官方文档 - 完整的项目说明和使用指南
• 许可证文件 - 项目许可证信息
• 版本信息 - 程序版本定义

通过本指南，您可以快速掌握UEFITool 0.28的核心功能和使用方法，为固件分析和修改工作提供有力支持。