CSMWrap 项目启动与配置教程

1. 项目的目录结构及介绍

CSMWrap 项目是一个开源项目，旨在在 UEFI-only 系统上恢复使用传统的 PC BIOS。以下是项目的目录结构及其各部分的简要介绍：

csmwrap/
├── .gitignore           # 指定 Git 忽略的文件和目录
├── .gitmodules          # 指定包含子模块的文件
├── GNUmakefile          # 项目的 Makefile 文件
├── LICENSE             # 项目许可证文件
├── README.md           # 项目自述文件
├── seabios-config       # SeaBIOS 配置文件
├── src/                # 源代码目录
│   └── ...             # 源代码文件
└── workflows/          # GitHub Actions 工作流目录
    └── ...             # 工作流配置文件

• .gitignore: 此文件中列出了一些文件和目录，这些是 Git 应该忽略的，比如编译产生的临时文件或私人配置文件。
• .gitmodules: 如果项目中有子模块，这个文件会列出所有子模块及其位置。
• GNUmakefile: 这是项目的 Makefile 文件，包含了构建项目所需的指令。
• LICENSE: 项目使用的许可证文件，本项目使用 LGPL-2.1 许可证。
• README.md: 项目自述文件，详细介绍了项目目的、功能、使用方法等。
• seabios-config: SeaBIOS 的配置文件，用于配置 SeaBIOS 的行为。
• src/: 源代码目录，包含了项目的所有源代码文件。
• workflows/: GitHub Actions 工作流目录，包含了自动化构建和测试的配置。

2. 项目的启动文件介绍

项目的启动文件是 csmwarp.efi，这是一个 EFI 可执行文件，作为引导加载程序使用。用户需要将其放置在 EFI 分区中，并在 BIOS/UEFI 设置中将其设置为启动项。

启动文件 csmwarp.efi 负责以下操作：

• 解锁传统 BIOS 内存区域（0xC0000-0xFFFFF）。
• 加载 SeaBIOS CSM 模块到内存中。
• 为传统应用配置内存映射。
• 设置 VGA BIOS，使用 EFI GOP 提供的信息。
• 根据 EFI 内存映射构建 E820 内存映射。
• 提供必要的兼容性表（如 ACPI、SMBIOS）。
• 初始化 CSM 模块和传统服务。
• 将控制权转移给传统引导过程。

3. 项目的配置文件介绍

项目的配置文件主要是 seabios-config，此文件用于配置 SeaBIOS 的行为。用户可能需要根据具体需求调整配置，以实现最佳的效果。

配置文件中可以设置的项目包括但不限于：

• 启用或禁用特定的 SeaBIOS 特性。
• 定义内存布局和映射。
• 配置硬件兼容性设置。
• 设定视频模式和其他硬件相关选项。

在修改配置文件后，用户通常需要重新构建项目以应用更改。

请注意，所有的更改和配置都应遵循项目的文档和指南，以确保兼容性和稳定性。