CSMWrap项目最佳实践教程

1. 项目介绍

CSMWrap是一个开源项目，旨在在UEFI-only系统上恢复传统的PC BIOS。它通过使用CSM（兼容性支持模块）和来自SeaBIOS项目的VESA VBIOS来模拟传统BIOS环境，使得可以在新系统上运行旧操作系统，如FreeDOS、Windows XP和Windows 7。

2. 项目快速启动

快速启动CSMWrap需要以下步骤：

1. 克隆项目到本地环境：

   git clone https://github.com/FlyGoat/csmwrap.git
   

2. 进入项目目录：

   cd csmwrap
   

3. 编译项目（确保你的环境中已经安装了必要的依赖）：

   make
   

4. 将编译出的csmwrap.efi文件放置到EFI分区中。

5. 重启系统，并在BIOS/UEFI设置中禁用Secure Boot和Above 4G Decoding。

6. 从csmwrap.efi启动。

3. 应用案例和最佳实践

应用案例

• 在QEMU模拟器中启动FreeDOS、Windows XP和Windows 7。
• 在某些真实硬件上启动，体验可能会有所不同。

最佳实践

• 确保在BIOS/UEFI设置中禁用了Secure Boot和Above 4G Decoding，这是因为CSMWrap无法在启用这些设置的情况下正常工作。
• 对于不支持EFI_LEGACY_REGION2_PROTOCOL的系统，CSMWrap会尝试使用PAM寄存器进行解码，但这可能并不总是有效。
• 对于Windows XP/7视频模式设置问题，可以考虑注入GPU驱动到OS镜像中，以避免使用VESA BIOS。

4. 典型生态项目

CSMWrap依赖于以下典型的生态项目：

• SeaBIOS: 提供CSM模块和VESA VBIOS。
• Nyu-EFI: 提供EFI C运行时、构建系统和头文件。
• EDK2: 提供代码片段。

通过以上介绍和实践，开发者可以更好地理解和使用CSMWrap项目，以实现在UEFI-only系统上运行传统操作系统。