edk2-DecSpecification 2.8

### edk2-DecSpecification 2.8：UEFI 平台描述文件 (DSC) 规范 #### 1. 引言 ##### 1.1 概览 本规范详细介绍了 EDK II（Extensible Firmware Interface Development Kit II）平台描述文件 (DSC) 的格式与处理方式。EDK II 是一个开源框架，用于开发 UEFI（Unified Extensible Firmware Interface）固件。DSC 文件是 EDK II 构建系统的核心组成部分之一，它定义了构建固件所需的各种组件、配置选项以及依赖关系。 ##### 1.2 术语 - **DSC 文件**：即 Platform Description File，用来描述构建特定平台所需的组件及其配置。 - **PCD**：Platform Configuration Data，用于在编译时或运行时配置固件的行为。 - **SkuIds**：用于标识不同 SKU 或变体的唯一 ID。 - **Library Classes**：库类，为模块提供通用功能的一组预定义函数和数据结构。 - **Components**：由一组源文件和资源组成的单元，是 DSC 文件中的主要元素之一。 ##### 1.3 相关信息 - **UEFI 规范**：提供了 UEFI 固件与操作系统之间的接口标准。 - **EDK II**：基于 UEFI 规范的开源固件开发框架。 - **Build System**：用于自动化构建过程的工具集。 ##### 1.4 文档约定 - 使用大括号 `{}` 表示可选部分。 - 使用尖括号 `<>` 表示必填项。 - 使用斜体 _表示强调_。 - 使用粗体 **表示关键词**。 #### 2. DSC 概览 ##### 2.1 处理概览 DSC 文件被 EDK II 构建系统解析，以确定如何构建特定平台的固件。此过程涉及多个阶段： 1. **解析 DSC 文件**：提取配置信息。 2. **处理宏定义**：替换宏以生成实际值。 3. **构建模块**：根据 DSC 文件中的配置编译源代码。 ##### 2.2 构建描述文件格式 DSC 文件采用文本格式编写，分为多个节（sections），每个节描述不同的构建属性和配置信息。 ##### 2.3 [Defines] 节处理 该节包含一系列宏定义，如基地址、版本号等。例如： ``` DEFINE = { "BASE_ADDRESS" = "0x00000000" } ``` ##### 2.4 [BuildOptions] 节 该节定义了编译器和链接器的选项，如警告级别、优化等级等。 ##### 2.5 [SkuIds] 节处理 用于指定不同的 SKU 变体，每个 SKU 可能有不同的配置需求。 ##### 2.6 [Libraries] 节处理 列出项目中使用的库文件，每个库都可能包含多个库类。 ##### 2.7 [LibraryClasses] 节处理 定义了项目中使用的库类，库类为模块提供了共享的功能。 ##### 2.8 PCD 节处理 PCD 节用于管理平台配置数据。分为以下几种类型： - **Fixed Pcds**：固定配置，在编译时设置。 - **Patchable In Module Pcds**：模块内可修改的配置，在编译时设置。 - **Patchable In Fv Pcds**：固件变量中可修改的配置，在运行时设置。 ##### 2.9 PCD 节 每个 PCD 类型都有其特定的处理方式，包括定义、默认值以及在何处进行修改。 ##### 2.10 PCD 数据库 所有 PCD 的集合，用于存储 PCD 的定义和值。 ##### 2.11 [Components] 节处理 描述构成固件的主要组件，包括源文件路径、编译选项等信息。 ##### 2.12 [UserExtensions] 节 允许用户自定义构建流程中的扩展行为。 ##### 2.13 [DefaultStores] 节 定义默认存储位置，如默认的库文件夹、源代码路径等。 #### 3. EDK II DSC 文件格式 ##### 3.1 构建多种架构 DSC 文件支持同时构建多种 CPU 架构（如 x86、x64、ARM 等），通过特定的配置实现跨平台兼容性。 ##### 3.2 一般规则 - DSC 文件必须遵循特定的格式和语法。 - 遵守一定的命名约定和编码标准。 ##### 3.3 平台 DSC 定义 平台 DSC 文件定义了特定平台的构建配置，包括： - 所需的库和库类。 - 组件和源文件列表。 - 编译器和链接器选项。 ##### 3.4 Header 节 包含文件头信息，如文件版本、作者等元数据。 ##### 3.5 [Defines] 节 定义宏，用于简化配置和提高代码可读性。 ##### 3.6 [BuildOptions] 节 指定编译器和链接器选项，这些选项影响最终固件的性能和兼容性。 ##### 3.7 [SkuIds] 节 定义不同的 SKU，使固件能够适应多种配置场景。 ##### 3.8 [Libraries] 节 列出项目中使用的库文件，有助于组织和管理外部依赖。 ##### 3.9 [LibraryClasses] 节 定义项目中使用的库类，为模块提供公共功能。 ##### 3.10 PCD 节 管理平台配置数据，确保固件的灵活性和可定制性。 ##### 3.11 [Components] 节 描述组成固件的主要组件，确保构建过程正确无误。 ##### 3.12 [UserExtensions] 节 提供扩展点，允许用户自定义构建过程中的特定行为。 ##### 3.13 [DefaultStores] 节 定义默认存储位置，有助于简化配置文件。 #### 附件 A：变量 列出了 DSC 文件中使用的变量和它们的用途，包括系统环境变量、预定义变量等。 #### 附件 B：EDK II DSC 示例文件 提供了完整的 DSC 文件示例，帮助开发者理解和应用 DSC 文件格式。 #### 附件 C：模块类型 定义了 EDK II 支持的模块类型，如 PEI、DXE 等。 #### 附件 D：VPD 数据文件 描述了 VPD（Vendor Provided Data）文件格式，用于存储固件配置信息。 #### 表格 表格列举了 DSC 文件中的关键元素，如宏定义、编译选项、PCD 类型等，提供了详细的数据结构和解释。 #### 图表 图表展示了 EDK II 构建系统的数据流，帮助理解构建过程中各组件之间的交互。 #### 修订记录 记录了文档的修订历史，包括修订日期、版本号等信息，便于跟踪文档的变化。 #### 致谢 感谢所有为 EDK II 和 UEFI 技术发展做出贡献的个人和组织。