当前位置：首页 > news >正文

UEFI学习笔记（四）：inf、dec和dsc

news 2025/5/15 8:00:36

一、基本概念

1、.inf 文件

.inf 文件用于描述特定的模块或驱动程序的详细信息和构建参数。它定义了模块的构建方式，包括模块的源文件、包含文件、库依赖关系和构建选项等。.inf 文件是构建过程中的主要输入文件，告诉构建系统如何编译和链接一个特定的模块。

.inf 文件通常包含以下信息：
1）模块定义：模块的名称、版本、作者等。
2）源文件：模块的源代码文件（例如 .c 文件）和头文件（例如 .h 文件）。
3）库依赖：模块需要的库和其他模块。
4）构建选项：编译器和链接器选项。
5）输出文件：构建输出的文件类型（例如 .efi 文件）。

必须块：
[Defines] 定义本模块的属性变量以及其他变量
[Sources] 列出本模块的所有源文件以及资源文件
[Packages] 列出本模块引用到的所有包的包声明文件
[LibraryClasses] 列出本模块要链接的库模块

非必须块：
[Protocol] 列出本模块用到的Protocol
[Guids] 列出本模块用到的GUID
[BuildOptions] 指定编译和链接选项
[Pcd] 用于列出本模块用到的Pcd变量

实例：

[Defines]
INF_VERSION                = 0x00010005
MODULE_TYPE                = DXE_DRIVER
ENTRY_POINT                = InitializeMyModule[Sources]
MyModule.c
MyModule.h[Packages]
MdePkg/MdePkg.dec[LibraryClasses]
DebugLib|MdePkg/Library/BaseDebugLibNull/BaseDebugLibNull.inf[Protocols]
gMyProtocolGuid|MyProtocol.inf

2、.dec 文件

dec 文件（Declaration File）主要用于定义库、PPI、PROTOCOL、GUID 等模块的公共接口和依赖项。通常用于模块或库的声明部分，向其他模块公开接口信息，类似于头文件的作用。

作用：
1）定义模块可以使用的 GUID、PPI、PROTOCOL。
2）声明模块对外公开的函数、全局变量等接口。
3）描述库类模块的依赖关系和接口定义。

必须区块： [Defines]
非必须块： [Includes] [LibraryClasses] [Guids] [Protocols] [Ppis] [PCD]

实例：

[Defines]
PACKAGE_NAME = MyModulePkg[Guids]
gMyProtocolGuid = {0xabcdef01, 0x2345, 0x6789, {0x12, 0x34, 0x56, 0x78, 0x90, 0xab, 0xcd, 0xef}}[Protocols]
gMyProtocolGuid|MyProtocol.inf[LibraryClasses]
DebugLib

3、. dsc文件

.dsc 文件全称为 Description File，它是整个固件包或模块的构建描述文件，包含了构建的配置、依赖关系和构建选项，通常用于构建 UEFI 固件映像时的配置管理。库的构建依赖dsc文件

作用：
1）定义要构建的模块、库和驱动程序。
2）指定不同的构建目标、工具链和平台设置。
3）配置固件各个模块的编译选项、依赖关系。

必须块：
[Defines] [LibraryClasses] [Components]
非必须块：
[PCD] [BuildOptions]

实例：

[Defines]
PLATFORM_NAME = MyPlatformPkg
DSC_SPECIFICATION = 0x00010005
OUTPUT_DIRECTORY = Build/MyPlatform[Components]
MyPlatformPkg/Drivers/MyDriver/MyDriver.inf[LibraryClasses]
MyLibraryClass|MyPlatformPkg/Library/MyLibraryClassLib.inf