.dsc .dec .fdf文件及包

   上一篇介绍了 .inf文件， .inf文件相当于Visual Studio中的工程文件。而 .dsc（Platform Description File）则相当于Visual Studio中的 solution 文件。每个包都要包含一个.dec（Package Declaration File）文件、一个 .dsc文件。如果这个包还用于固件Iamge或Option Rom Image的生成，则还需要添加 .fdf（Flash Description File）文件， .fdf文件还用于启动Image。

   build命令用于编译包，编译时需要一个 .dsc文件以及一个或多个 .inf文件。

   GenFW命令用于制作固件或Option Rom Image，它需要一个 .dec文件和一个 .fdf文件。

   EDK2文件及EDK2工具链命令之间的关系如下：

   接下来了解一下常用的两种文件： .dsc与 .dec文件。

  • 1、 .dsc文件

    .inf用于编译一个模块，而 .dsc文件用于编译一个Package，它包含了[Defines]、[LibraryClasses]、[Components]几个必须部分以及[PCD]、[BuildOptions]等几个可选部分。

    1. [Defines]块

      [Defines]用于设置build相关的全局宏变量，这些变量可以被 .dsc文件的其他模块引用。[Defines]块必须时 .dsc文件的第一个部分，格式如下：

      [Defines]宏变量名 = 值EDFINE 宏变量名 = 值EDK_GLOBAL 宏变量名 = 值

      [Defines]块中通过DEFINE和EDK_GLOBAL定义的宏可以在 .dsc文件和 .fdf文件中通过$（宏变量名）使用。

      .dsc文件中[Defines]块必须定义的宏变量。

      宏变量名 值类型 说明
      DSC_SPECIFICATION 数值 DSC Spec 1.22对应的值为0x00010006.目前的常用值为0x00010005.DSC必须保证向后兼容
      PLATFORM_GUID GUID 平台GUID，每个.dsc文件必须有一个唯一的GUID
      PLATFORM_VERSION 数值 .dsc文件变化时，增加此数值
      PLATFORM_NAME 标识符 标识符字符串中只能包含英文字符数字、横线、下划线
      SKUID_IDENTIFIER 标识符 该宏可以通过命令行在build时传入。可以为Default或[SkuIds]中的一个
      SUPPORTED_ARCHITECTUPES 列表 通过“|”分隔的列表，表示该 .dsc所支持平台的体系结构。例如支持IA32和X64：IA32|X64
      BUILD_TARGETS 列表 通过“|”分隔的列表，表示该 .dsc所支持的编译目标，例如BUILD或BUILD|RELEASE。

      .dsc文件 [Defines]块的可选宏变量

      宏变量名 值类型 说明
      OUTPUT_DIRECTORY 路径 目标文件路径。可以时绝对路径，也可以是相对路径。默认为(WORKSPACE)/Build/(WORKSPACE)/Build/(WORKSPACE)/Build/(PLATFORM_NAME)
      FLASH_DEFINTTION 文件名FILE_NAME FDF文件。可以是文件名，也可以是带带路径的文件名。如果仅是文件名，则该文件必须在.dsc所在的目录
      BUILD_NUMBER 最多四个字符 用于Mkefile文件
      FIX_LOAD_TOP_MEMORY_ADD RESS 地址 驱动、应用程序在内存中的起始地址
      TIME_STAMP_FILE 文件名 时间戳文件。可以是文件名，也可以是带路径的文件名。该文件中包含了一个时间戳，所有编译过程中生成的文件都使用该时间戳
      DEFINE MACRO=PATH|Value ? 宏定义，定义的宏可以在 .dsc文件中调用。例如，DEFINE DEBUG_ENABLE_OUTPUT=FALSE，在后续的 .dsc文件中可以直接：!if$(DEBUG_ENABLE_OUTPUT) \n !endif
      EDK_GLOBAL MACRO=PATH|Value 仅在EDK模块适用，EDK2模块会自动忽略
      RfC_lANGUAGES RFC 4646语言代码列表 RFC4646语言代码字符串中，各个语言代码之间使用分号“;”分隔。用于在AutoGen阶段处理Unicode字符串。字符串必须用“包裹”?
      VPD_TOOL_GUID GUID 在AutoGen阶段调用此GUID对应的VPD程序。VPD程序定义在Conf\tool_def.txt文件中，默认为BPDG
      PCD_INFO_GENERATION_GENERATION BOOL值 TRUE表示在PCD数据库中存在PCD信息

      Nt32Pkg中 .dsc文件的[defines]部分：

      [Defines]PLATFORM_NAME              =NT32PLATFORM_GUID             =EB12332-123S-21XZ-1DD1-AS231ER523C2PLATFORM_VERSION           =0.4DSC_SPECIFICATION          =0x00010005OUTPUT_SPECIFICATION        =Build/NT32SUPPORTED_ARCHITECTURES     =IA32BUILD_TARGETS             =DEBUG|RELEASESKUID_IDENTIFIER         =DEFAULTFLASH_DEFINITION           =Nt32Pkg/Nt32Pkg.fdf

    2. [LibraryClasses]块

      在[LibraryClasses]块中定义了库的名字以及库的 .inf文件的路径。这些库可以被[Components]块引用。

      1）语法：

         [LibraryClasses]块 语法如下：

      #方法一
[LibraryClasses.$(Arch).$(MODULE_TYPE)]LibraryName | Path/LibraryName.inf

         或

      #方法二
[LibraryClasses.$(Arch).$(MODULE_TYPE), LibraryClasses.$(Arch1).$(MODULE_TYPE1)]LibraryName | Path/LibraryName.inf

         (Arch)和(Arch)和(Arch)和(MODULE_TYPE)是可选项。用“ , ”表示并列关系，块内的库对LibraryClasses.(Arch).(Arch).(Arch).(MODULE_TYPE)和LibraryClasses.(Arch1).(Arch1).(Arch1).(MODULE_TYPE1)都有效。

         $(Arch)表示体系结构，可以是下列值之一：IA32、X64、IPF、EBC、ARM、common。其中，common表示对所有体系结构都有效。

         KaTeX parse error: Undefined control sequence: \? at position 35: …*类别**，块内列出的库只能（\̲?̲用于）提供(MODULE_TYPE)类别的模块链接。$(MODULE_TYPE)可以是以下值：SEC、PEI_CORE、PEIM、DXE_CORE、DXE_SAL_DRIVER、DEX_RUNTIME_DRIVER、BASE、UEFI_DRIVER等。

         通常， .dsc文件中都有[LibraryClasses]区块，表示块内定义的库对所有体系结构和所有类型的模块都有效。

      2）示例：

         在Nt32Pkg.dsc中有：

      [LibraryClasses.common.PEIM, LibraryClasses.common.PEI_CORE]HobLib | MdePkg/Library/PeiHobLib/PeiHobLib.inf

         在ShellPkg.dsc中有：

      [LibraryClasses.ARM]NULL | ArmPkg/Library/CompilerIntrinsicsLib/CompilerIntrinsicsLib.inf

         引用库是在 .inf 文件的[LibraryClasses]块中完成的。例如，上上篇博客中第一个示例程序的 .inf文件中引用了UefiApplicationEntryPoint和UefiLib，如下代码所示：

      [LibraryClasses]UefiApplicationEntryPointUefiLib

    3. [Components]块

      在[Components]块内定义的模块都会被build工具编译、并生成.efi文件，其格式如下：

      #格式一
[Components.$(Arch)]Path\Exectuables.inf

      或者

      #格式二
[Components.$(Arch)]Path\Exectuables.inf{<LibraryClasses> #嵌套块LibraryName | Path/LibraryName.inf<BuildOptions> #嵌套块#子块中还可以包含<Pcds*>}

         如果Path是相对路径，则相对路径起始于(WORKSPACE)，(WORKSPACE)，(WORKSPACE)，(WORKSPACE)通常是EDK2的根目录。在Path中可以使用通过 DEFINE命令 定义的宏。例如：

      [Components]DEFINE MYSOURCE_PATH = D:/Source$(MYSOURCE_PATH)/Hello.inf #相当于 D:/Source/Hello.inf

         格式二中大括号内的内容仅对本模块有效，例如下面的代码中[Components]声明的DevicePathDxe.inf会调用在MdePkg/Library/UefiDevicePathLib/UefiDevicePathLib.inf中定义的DevicePathLib库，而其它的模块则使用在全局[LibraryClasses]块中声明的UefiDevicePathLibDevicePathProtocol.inf对应的DevicePathLib库。

      [LibraryClasses]
DevicePathLib | MdePkg/Library/UefiDevicePathLibDevicePathProtocol/UefiDevicePathLibPathProtocol.inf[Components]...MdeModulePkg/Universal/DevicePathDxe/DevicePathDxe.inf{<LibraryClasses>DevicePathLib | MdePkg/Library/UefiDevicePathLib/UefiDevicePathLib.inf}

         下面编写一个MdeMoudlePkg.dsc中的一个实例，这个块内的模块对IA32、X64和IPF体系结构有效：

      [Components.IA32, Components.X64, Components.IPF]MdeModulePkg/Universal/Network/UefiPxeBcDxe/UefiPxeBcDxe.infMdeModulePkg/Universal/DebugSupportDxe/DebugSupportDxe.infMdeModulePkg/Universal/EbcDxe/EbcDxe.inf

    4. [BuildOptions]块

         [BuildOptions]格式在 .inf文件中以及进行过介绍， .dsc文件的[BuildOptions]与 .inf文件的[BuildOptions]格式大致相同，区别在于 .dsc文件的[BuildOptions]对 .dsc文件内的所有模块有效。 .dsc文件的[BuildOptions]模块格式如下：

      [BuildOptions.$(Arch).$(CodeBase)][编译器]:[$(Target)]_[Tool]_[$(Arch)]_[CC|DLINK]_FLAGS =

         (Arch)与(Arch)与(Arch)与(CodeBase)都是可选项。(CodeBase)的值是EDK和EDK2中的一个。(CodeBase)的值是EDK和EDK2中的一个。(CodeBase)的值是EDK和EDK2中的一个。(Arch)是体系结构，如IA32、X64等。

         $(Target)选项的值是DEBUG、RELEASE、*中的某个；Tool是编译工具的名字，如VS2012、GCC44等；CC表示编译选项；DLIKN表示连接选项。

      AppPkg.dsc中的[BuildOptions]块中的代码如下：

      [BuildOptions]
!ifndef $(EMULATE)INTEL:*_*_*_CC_FLAGS      = /Qfreestanding /D UEFI_C_SOURCEMSFT:*_*_*_CC_FLAGS       = /X /Zc:wchar_t /D UEFI_C_SOURCE...!elseINTEL:*_*_IA32_CC_FLAGS       = /Od /D UEFI_C_SOURCEMSFT:*_*_IA32_CC_FLAGS       = /Od /D UEFI_C_SOURCE...!endif

         在 .dsc文件中可使用" ! “命令。” !include “用于加载其他文件。” !if、!ifdef、!ifndef、!else、!end"等则是条件处理语句。

         最后简单介绍下[PCD]块。[PCD]块用于定义平台配置数据。其目的是在不改动 .inf文件和源文件的情况下完成对平台的配置。例如在UEFI模拟器Nt32Pkg的 .dsc文件Nt32Pkg.dsc 中可以通过PCD的PcdWinNtFileSystem配置模拟器文件系统路径，如下所示：

      gEfiNt32PkgTokenSpaceGuid.PcdWinNtFileSystem | L".!..\..\..\..\EdkShellBinPkg\Bin\Ia32\Apps" | VOID* | 106

         配置文件被" | "分成四个部分：第一部分中gEfiNt32PkgTokenSpaceGuid是命名空间，PcdWinNtFileSystem是变量名；第二部分是值；第三部分是变量类型。第四部分是变量数据的最大长度。

         在源文件中可以通过LIbPcdGetPtr(_PCD_TOKEN_PcdWinNtFileSystem)获得gEfiNt32PkgTokenSpaceGuid.PcdWinNtFileSystem定义的值。

  • 2、 .dec文件

       .dec文件定义了公开的数据和接口以供其他模块使用。包含有必须模块[Defines]以及可选区块[Includes]、[LibraryClasse、[Guids]、[Protocols]、[Ppis]和[PCD]等部分。

    1. [Defines]块

         [Defines]块用于提供package的名称、GUID、版本号等信息，格式如下：

      [Defines]Name = Vlaue

         其中，Name的取值范围是[DEC_SPECIFICATION、PACKAGE_NAME、PACKAGE_GUID、PACKAGE_VERSION]。

         例如，MdePkg.dsc中的[Defines]部分如下所示：

      [Defines]Dec_SPECIFICATION = 0x00010001PACKAGE_NAME = MdePkgPACKAGE_GUID = 1W2323F-F31S-1242-SDC1-F23C123F1211PACKAGE_VERSION = 1.03

    2. [Includes]块

         [includes]块列出了本Package提供的头文件所在的目录，格式如下：

      [Includes.$(Arch)]Path

         Path只能是相对路径，该相对路径起始于本Package的.dsc所在的目录。

         MdePkg.dec文件中的[Includes]部分如下：

      [Include]Include[Include.IA32]               #编译 32 位程序时的头文件路径Include/Ia32[Include.X64]              #编译x86——64位程序时的头文件路径Include/X64

    3. [LibraryClasses]块

         package可以通过 .dec文件对外提供库，每个库都必须有一个头文件，放在Include\Library目录下。[LibraryClasses]块用于明确库和头文件的对应关系。其格式如下：

      [LibraryClasses.$(Arch)]LibraryName | Path/LibraryHeader.h

         MdePkg.dec中[LibraryClasses]块中代码的一部分如下：

      [LibraryClasses]UefiUsbLib | Include/Library/UefiUsbLib.h[LibraryClasses.IA32, LibraryClasses.X64]SmmLib | Include/Library/SmmLib.h

    4. [Guids]块

         在Package\Include\Guid目录中有很多文件，每个文件内定义了一个或几个GUID，例如在MdePkg\Include\Gpt.h文件中定义了Gpt分区相关的GUID，如下所示：

      extern EFI_GUID gEfiPartTypeUnusedGuid;
extern EFI_GUID gEfiPartTypeSystemPartGuid;
extern EFI_GUID gEfiPartTypeLegacyMbrGuid

         可以看出这些定义只是声明了变量，并未对其进行赋值。真正的常量定义?在AutoGen.c中，其值定义在 .dec文件的[Guids]块中。格式为：

      [Guid.$(Arch)]GUIDName = GUID

         上文中提到的Gpt相关的GUID，定义在在MdePkg.dec中，这些GUID定义如下：

      [Guids]
...
## include/Guid/Gpt.hgEfiPartTypeLegacyMbrGuid = { 0x024DEE41, 0x33E7, 0x11D3, { 0x9d, 0x69, 0x00, 0x08, 0xc7, 0x81, 0xF3, 0x9F}}gEfiPartTypeSystemPartGuid = { 0xC12A7328, 0xF81F, 0x11D2, { 0xBA, 0x4B, 0x00, 0xA0, 0xC9, 0x3E, 0xC9, 0x3B}}gEfiPartTypeUnusedGuid = { 0x00000000, 0x0000, 0x0000, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}}

    5. [Protocols]块

         与Guids相似，在Package\Include\Protocols 目录下有很多头文件，每个头文件定义了一个或多个Protocol，这些Protocol的GUID值就定义在 .dec文件的[Protocols]块，格式如下：

      [Protocols.$(Arch)]ProtocolName = GUID

         如，在MdePkg\Include\Protocol目录下BlockIo.h定义的BlockIo Protocol

      extern EFI_GUID gEfiBlockIoProtocolGuid;

         gEfiBlockIoProtocolGuid的值定义在MdePkg.dec的[Protocls]块中。

      [Protocols]gEfiBlockProtocolGuid = { 0x964EB21, 0x6459, 0x11D2, { 0x8E, 0x39, 0x00, 0x00, 0xC9, 0x69, 0xE2, 0x2C}}

    6. [Ppis]块、[PCD]块、[UserExtensions]块

         [Ppis]块用于定义源文件中用到的PPI（PPI是PEI阶段，PEI模块间通信的接口），语法类似于[Protocols]。

         [PCD]块是 .dsc文件中对[PCD]块的补充，

         [UserExtensions]块

UEFI原理与编程第二章学习- .dsc .dec .fdf文件与包相关推荐

  1. UEFI原理与编程（四）（dec dsc inf文件）

    1 .inf文件 以下面 .inf文件为例 [Defines] # 块用于定义模块的属性和其他变量,块内定义的变量可被其他块引用INF_VERSION = 0x00010006 #INF 标准的版本号 ...

  2. Linux_《Linux命令行与shell脚本编程大全》第二章学习总结

    时间:2017年04月05日 说明:本文部分内容均摘取自书籍<Linux命令行与shell脚本编程大全>,版权归原作者所有.<Linux命令行与shell脚本编程大全>(第三版 ...

  3. UEFI原理与编程(一)

    第一章 UEFI概述(Unified Extensible Firmware Interface 统一的可扩展固件接口) 常见缩写及描述: 缩略词 全名 描述 UEFI Unified Extensi ...

  4. 数据结构第二章学习总结

    数据结构第二章学习总结 在数据结构第二章,我们学习了线性表的两种结构顺序和链式结构,学习了他们的定义,不同,存储结构和逻辑结构,还有一些基本的操作. 在学习过程中,我发现了许多问题:①书上的大多数代码 ...

  5. UEFI原理与编程实践--EFI System Table中的输入输出

    这一节UEFI原理与编程的书籍里面貌似没有提到,不过在我上次使用飞腾源代码增加功能的过程中发现logo界面的左上角有个光标,后来发现源代码也有,这就让有强迫症的人非常不爽啦,这个光标怎么来的呢,我找了 ...

  6. 【ERP】ERP发展阶段有哪些？对ERP发展各个阶段概念的理解（20年3月29日第二章学习笔记）

    ERP发展历经五大阶段 1.ROP库存订货点法 2.MRP物料需求计划 3.闭环MRP 4.MRPII制造业资源计划 5.ERP企业资源计划 1.ROP库存订货点法 ROP,库存订货点法,很好理解,就 ...

  7. Hinton机器学习与神经网络课程的第二章学习笔记

    Hinton机器学习与神经网络课程的第二章学习笔记 该笔记为自己以后方便查阅,要是有大神感觉我的笔记有哪些地方记的有误差或者不对的话也欢迎指出 文章目录 Hinton机器学习与神经网络课程的第二章学习 ...

  8. 简学Python第二章__巧学数据结构文件操作

    Python第二章__巧学数据结构文件操作 欢迎加入Linux_Python学习群  群号:478616847 目录: 列表 元祖 索引 字典 序列 文件操作 编码与文件方法 本站开始将引入一个新的概 ...

  9. 郑捷《机器学习算法原理与编程实践》学习笔记（第四章 推荐系统原理）（三）SVD...

    4.5.1 SVD算法回顾 A = U∑VT 其中:A是N*M的矩阵,U是M*M的方阵(里面向量正交,称为左奇异向量),∑是一个M*N的矩阵,VT是一个N*N的矩阵(里面向量正交,右奇异向量) 那么奇 ...

最新文章

  1. TZOJ上的C语言作业答案,C语言编程练习
  2. 第05课：神经网络基础知识
  3. Spark性能优化指南：高级篇
  4. dc/os_DC / OS中具有Java和数据库应用程序的服务发现
  5. DUMP文件分析6：简单的堆破坏示例
  6. 太方便 微信能精准搜图片了！网友：出点有用的功能有多难？
  7. html 苹果微信录音js,基于JS开发微信网页录音功能的实例代码
  8. Web Service接口如何自动化测试
  9. 【壁纸小程序】搭建自己的壁纸小程序-微信抖音双端
  10. 网络存储NAS网络存储器术语解释
  11. 针对百度的常规网页优化策略
  12. android 横向头像栏,Android实现个人资料页面头像背景模糊显示包(状态栏)
  13. 微信小程序：各种Tab栏
  14. vSphere7虚拟机迁移报兼容性问题无法迁移
  15. 向日葵橙色调色Lr预设分享
  16. 你幸福的背后，是我孤独的背影
  17. GA-Z77-D3H主板装linux系统出现网卡找不到的问题
  18. xlsx是什么格式的文件?怎么打开
  19. 2.4G和5GWiFi的区别
  20. excel 中任意几个数相加后等于一个数

热门文章

  1. 删除jar包中的.class文件保留源码文件.java文件
  2. Maven Nexus 私库的搭建
  3. js实现周历插件方法
  4. Mac /etc目录下文件示例
  5. Linux下C语言实现HTTP文件服务器和TCP协议实现网络数据传输
  6. 刚刚出炉的 IrisSkin，来个鲜的（附：换肤控件对比）
  7. 青蛙跳台阶问题（史上最详细）
  8. 在魅族、vivo手机下Amaze UI底部导航消失问题
  9. 有时，去治愈；常常，去帮助；总是，去安慰
  10. mysql optimizer mrr_mysql8 参考手册--optimizer_switch优化