ReBarUEFI 实用指南：从功能解析到进阶配置

2026-03-12 05:29:55作者：冯梦姬Eddie

📋 核心功能解析指南

ReBarUEFI 是一个专注于为几乎所有 UEFI 系统提供 Resizable BAR（可调整大小的基址寄存器）支持的开源项目。Resizable BAR 技术允许 CPU 直接访问整个显卡内存，从而提升系统性能，尤其在游戏和图形密集型应用中表现显著。

核心功能模块

项目主要通过以下三个功能模块实现其核心目标：

ReBarDxe：UEFI 驱动模块，负责在系统启动阶段配置 PCI 设备的 Resizable BAR 功能。该模块通过 DXE（驱动执行环境）阶段的驱动程序与硬件交互，实现 BAR 大小的动态调整。
ReBarState：状态管理工具，提供对 Resizable BAR 状态的监控和控制功能。通过该工具，用户可以查看当前 BAR 配置状态，并进行必要的调整。
UEFIPatch：补丁集合，包含针对不同硬件平台的特定补丁，解决各种兼容性问题，确保 Resizable BAR 在不同主板和显卡组合上正常工作。

核心文件功能图谱

文件/目录	功能描述	技术要点
ReBarDxe/ReBar.c	核心驱动实现	PCI 设备枚举、BAR 寄存器配置
ReBarDxe/include/PciHostBridgeResourceAllocation.h	资源分配接口	UEFI 资源分配协议定义
ReBarDxe/include/pciRegs.h	PCI 寄存器定义	标准 PCI 配置空间寄存器映射
ReBarState/ReBarState.cpp	状态管理工具实现	BAR 状态查询与修改逻辑
UEFIPatch/	硬件平台补丁集合	针对不同芯片组的兼容性修复
tools/uuidconv.py	UUID 转换工具	用于生成和转换 UEFI 所需的 UUID

图：Resizable BAR 启用状态监控界面示例，显示了系统中 Resizable BAR 的启用状态及相关配置信息

🔧 环境准备指南

在开始使用 ReBarUEFI 之前，需要准备以下开发环境和工具：

硬件要求

支持 UEFI 的主板（2015 年后的大多数主板）
支持 Resizable BAR 的显卡（AMD RDNA 及以上架构，NVIDIA Turing 及以上架构）
至少 4GB 内存
可用的 USB 闪存盘（至少 4GB）

软件要求

操作系统：Windows 10/11 或 Linux（推荐 Ubuntu 20.04+）
编译工具链：
- GCC 或 Clang 编译器
- GNU Make 构建工具
- Python 3.8+（用于运行辅助脚本）
UEFI 开发环境：
- EDK II 开发套件
- UEFI Shell（用于调试和测试）
版本控制工具：Git

环境搭建步骤

克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/re/ReBarUEFI

安装依赖包（以 Ubuntu 为例）：

sudo apt update
sudo apt install build-essential python3 git

配置 EDK II 环境：

# 下载 EDK II 源码
git clone https://github.com/tianocore/edk2.git
cd edk2
git submodule update --init
make -C BaseTools
source edksetup.sh

🚀 实操指南

编译项目

进入项目目录：
```
cd ReBarUEFI
```
编译 ReBarDxe 驱动：
```
cd ReBarDxe
python buildffs.py
```
编译 ReBarState 工具：
```
cd ../ReBarState
cmake .
make
```

安装与配置

将编译生成的 ReBarDxe.ffs 文件复制到 UEFI 固件的相应位置，具体路径取决于您的主板型号和固件结构。
创建启动介质：
- 使用 Rufus 或类似工具创建 UEFI 启动的 USB 闪存盘
- 将 ReBarState 可执行文件复制到 USB 闪存盘
进入 UEFI 设置：
- 重启计算机，按特定键（通常是 Del、F2 或 F1）进入 BIOS/UEFI 设置
- 启用 "Above 4G Decoding" 和 "Resizable BAR" 选项（如果可用）
- 保存设置并重启

使用 ReBarState 工具验证配置：

# 在 UEFI Shell 中执行
fs0:  # 切换到 USB 闪存盘
ReBarState.efi  # 运行状态检查工具

应用补丁

针对特定硬件组合可能需要应用补丁：

查看 UEFIPatch 目录中的可用补丁：
```
ls UEFIPatch/
```
根据您的硬件配置选择合适的补丁，例如针对 Intel Haswell 平台的 USB3 补丁：
```
# 具体补丁应用方法请参考补丁文件中的说明
```

⚙️ 进阶技巧详解

自定义 BAR 大小

通过修改 ReBarDxe 驱动中的配置，可以自定义 BAR 大小以适应特定需求：

打开 ReBarDxe/ReBar.c 文件
找到 SetBarSize 函数

修改以下代码中的 BAR 大小值（以字节为单位）：

// 示例：设置 BAR 大小为 2GB (2 * 1024 * 1024 * 1024)
UINT64 NewBarSize = 0x80000000;
Status = PciHostBridgeSetBarSize (PciRootBridgeIo, DevicePath, BarIndex, NewBarSize);

自动化部署脚本

创建一个简单的部署脚本，简化多次测试过程：

#!/bin/bash
# deploy_rebar.sh - 自动部署 ReBarUEFI 驱动

# 编译驱动
cd ReBarDxe
python buildffs.py
cd ..

# 复制到 USB 设备（假设挂载在 /mnt/usb）
sudo cp ReBarDxe/ReBarDxe.ffs /mnt/usb/EFI/OC/Drivers/

echo "部署完成，请重启计算机并进入 UEFI 设置"

常见配置问题排查

问题症状	可能原因	解决方案
Resizable BAR 选项灰色不可选	主板 BIOS 不支持或未启用 Above 4G Decoding	更新主板 BIOS 至最新版本并启用 Above 4G Decoding
启用后系统不稳定	BAR 大小设置过大或硬件不兼容	尝试减小 BAR 大小或应用相应的硬件补丁
ReBarState 显示 "Unsupported GPU"	显卡不支持或驱动不匹配	更新显卡驱动或检查显卡是否支持 Resizable BAR
编译失败	依赖项缺失或 EDK II 环境配置错误	检查 EDK II 环境变量设置，确保所有依赖已安装

🚫 新手常见误区

忽略 BIOS 更新：许多用户直接尝试安装 ReBarUEFI 而不更新主板 BIOS，导致功能无法正常工作。始终确保您的主板 BIOS 是最新版本，以获得最佳兼容性。
错误配置 BAR 大小：设置过大的 BAR 大小可能导致系统不稳定。建议从较小的 BAR 大小开始测试，逐步增加至最佳值。
忽视硬件兼容性：并非所有硬件组合都能完美支持 Resizable BAR。在尝试使用 ReBarUEFI 之前，应先查阅硬件兼容性列表，了解您的具体硬件是否需要特定补丁。
混淆 UEFI 和 Legacy BIOS：ReBarUEFI 仅适用于 UEFI 启动模式。如果您的系统使用 Legacy BIOS（传统 BIOS）模式，需要先转换为 UEFI 模式才能使用该项目。