udk开发-稀里糊涂

udk开发-稀里糊涂一 EDK2 简介 1 EDK2 工作流 二 EDK2 Packages 1 Packages 介绍 EDK2 Packages 是一个容器 其中包含一组模块及模块的相关定义 每个 Package 是一个 EDK2 单元 整个 Project 的源代码可以被分割成不同的 Pkg 这样的设计不仅可以降低耦合性 还有利于分发和复用 1 1 EDK2

大家好,我是讯享网,很高兴认识大家。

一、EDK2简介
1.EDK2工作流
​

二、EDK2 Packages
1.Packages介绍
​ EDK2 Packages是一个容器,其中包含一组模块及模块的相关定义。每个Package是一个EDK2单元。

整个Project的源代码可以被分割成不同的Pkg。这样的设计不仅可以降低耦合性,还有利于分发和复用。

​ MdeModulePkg包中有一组符合UEFI和PI规范的跨平台驱动程序。在开发新的UEFI和PI驱动时可以用来参考。

DEC文件主要包括以下部分:

(1)[Defines]

​ 定义PKG的名字和PKG的GUID

(2)[Includes]

​ 列出公共头文件的所处目录的根目录

(3)[LibraryClasses]

​ 列出在Include\Library下的每个Library Class头文件

(4)[Guids]

​ 给Include\Guid下的Guid赋值

(5)[Ppis]

​ 给Include\Ppi下的Ppi赋Guid值

(6)[Protocols]

​ 给Include\Protocol下的Protocol赋Guid值

(7)PCDs

​ 相关类型的PCD声明:FeatureFlag, FixedAtBuild, PatchableInModule, Dynamic, and DynamicEx。Dynamic类型的PCD在第四章:附录章节还有补充说明。

DSC文件主要包括以下部分:

(1)[Defines]

​ 设置Build的相关信息,如build输出目录、build目的、Guid和build arch

(2)[LibraryClasses]

​ 对每个LibraryClasses指定选择的Library实例

(3)PCD

​ 用于配置[Components]部分中各模块使用的PCD类型和PCD值。

​ 列出所有将被编译的Module,如Drivers, Application, and Library Instances

Path是相对路径,相对于Package根目录

DSC文件写法示例:

2.Packages管理
2.1.创建Package
2.1.1.创建要求
(1)将有意义的包名作为包目录名,并创建一个包目录,例如PackageNamePkg

(2)在包根目录下创建包DEC和DSC文件来描述这个包

(3)创建子目录来包含不同的源文件

​ Module可以以源代码或EFI二进制格式发布,Module的内容可以是下列几种类型:

(1)Raw data binary

例如:$(WORKSPACE)\MdeModulePkg\Logo\Logo.inf ,这就是包含了一个logo bitmap的image

(2)可选的设备ROM驱动

(3)独立的UEFI驱动或者UEFI应用

(4)一个 .lib 形式的library instance

(1)区分不同类型模块的生命周期

​ 例如:PEIM在PEI阶段调度,DXE_DRIVER或uefi_driver在DXE阶段

(2)表示不同类型模块的二进制image

(3)为不同类型的模块指定合适的library instance

主要的EDKII Module类型:

(1)选择或者创建一个Package,来存放Module

(2)为该Module创建一个目录,并且放入一个inf文件

(3)在inf文件中添加Package dependencies

(4)在inf文件中添加PPI Protocol Guid等相关dependencies

(5)如果模块依赖PPI Protocol Guid,则需要加入项[depex]

(6)创建源文件,并且在inf中填入源文件的相对路径

(1)Module的基础信息有:名字、GUID、模块类型等

(2)Module所依赖的所有Packages路径(根目录的相对路径)

所有模块都依赖MdePkg,需要将其加入
如果使用来自Intel框架规范的定义,则IntelFrameworkPkg也是必需的
如果使用到了其它Package中的内容,则需要添加其它Packeage的dec文件

(5)模块所需的所有pcd和Library类的列表

(6)其它内容,例如不同类型Module需要的不同的依赖部分

App Module的inf文件:

Library Module的inf文件

(1)不同的体系结构Source文件,放在不同的模块下,例如:

(2)使用的不同工具链需要标注,例如:

相关Tool Tag

​ Library实例(Instance)根据不同Platform,和相同Platform的不同阶段,其具体实现会有所差异。

(2)在INF文件中,给Library Class添加dependency

(3)在代码头文件中,包含LibraryClass

头文件的路径是相对路径,相对于package DEC文件[include]中写的路径

实例

​ EDK II提供了以下类型的PCD:

(2)在Module的INF文件中,给MdePkg添加dependency

(4)使用PcdLib提供的接口进行PCD Value的操作

PCD操作函数:

PCD添加与使用实例:

(2)相应头文件必须清楚包含在Source code的头中

头文件中都是相对路径,相对于package DEC文件[include]中写的路径

​ 通过它,可以确定PEIM和DXE模块的调度顺序。

具体运算法则描述,参考Platform Initialization Specification的Dependency Expressions 章节和
Dependency Expression Grammar章节
3.11.Define Library Class
​ Library Instance总是与Library Class相关,Library Instance实现了Library Class中定义的所有接口。

因此,==Library Class名必须在Library Instance的INF文件的[definitions]==中说明。

如下所示:

UefiDriverEntryPoint 是Library Class的名字,这个名字由Library Instance所来。

DXE_DRIVER和DXE_RUNTIME_DRIVER是这个Library Instance所支持的类型。

示例图:

​ VFR文件用来描述form(即格式)资源。VFR文件的用法和其它Source Code用法相似。

需要将其在Module的INF文件的[Sources]部分中列出。

用法示例:

(2)打印VFR

​ 在Module编译时,vfr文件会由Vfr编译器编译为一个.vfr文件,并且作为全局数组变量插入到Module image的IFR二进制区域中。这个全局数组变量的名字是:Vfr文件名+Bin。

示例如下:

Inventory.vfr in the MdeModulePkg\Universal\DriverSampleDxe driver

is compiled into the global array variable InventoryBin.

(3)将VFR全局数组变量加入HII数据库

​ 使用以下代码段:

//
// Create HII driver handle, paramter DriverHandle will hold the
// returned new handle.
// HiiLibCreateHiiDriverHandle defined in UefiHiiLib library class.
//
Status = HiiLibCreateHiiDriverHandle(&DriverHandle);
//
// Prepare HII package list, parameter InventoryBin is the VFR form data
// HiiLibPreparePackageList defined in UefiHiiLib library class
//
PackageList = HiiLibPreparePackageList (2,
&mInventoryGuid,
InventoryBin,
DriverSampleStrings);
ASSERT (PackageList != NULL);
//
// Create package into HII database via EFI_HII_PROTOCOL->NewPackageList
//
Status = gHiiDatabase->NewPackageList (
gHiiDatabase,
PackageList,
DriverHandle,
&HiiHandle
);

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
3.14.2 Unicode Strings
​ Unicode字符串被放到.uni文件中,并在Module的INF文件的[Sources]部分列出,和C文件一样。

示例如图:

(1)打印Unicode String文件

​ uni文件中的内容会被编译工具解析和编译为一个二进制字符串包数组。这个二进制数组的名字为ModuleName+ “Strings”。

例如:MdeModulePkg\Universal\DriverSampleDxe 中的inventorystring.uni最终的二进制数组名将会是:

extern UINT8 DriverSampleStrings[];
1
(2)将Strings array variable 添加进 HII Database

//
// Create HII driver handle, paramter DriverHandle will hold the
// returned new handle.
// HiiLibCreateHiiDriverHandle defined in UefiHiiLib library class.
//
Status = HiiLibCreateHiiDriverHandle(&DriverHandle);
//
// Prepare HII package list, parameter DriverSampleStrings is the
// strings binary data.
// HiiLibPreparePackageList defined in UefiHiiLib library class
//
PackageList = HiiLibPreparePackageList (2,
&mFormSetGuid,
DriverSampleStrings,
VfrBin);
if (PackageList == NULL) {
return EFI_OUT_OF_RESOURCES;
}
//
// Create package into HII database via EFI_HII_PROTOCOL->NewPackageList
//
Status = HiiDatabase->NewPackageList (
HiiDatabase,
PackageList,
DriverHandle[0],
&HiiHandle[0]);

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
4. Module的编译
​ 当Module Source Code完成以后,Module的INF文件会被加入到Platform的DSC文件里,Module将被编译到预期的二进制Image中。

​ EDK2编译系统支持编译Library Image、EFI Image、OptionRom Image。

​ DSC的[Defines]部分会列出所有支持的体系。[Components]部分会详细列出Module的支持体系。

示例:

​ Module INF文件的==[LibraryClasses] 部分列出了所有需要的Library Class==,这些Library Class都是Library Instance所产生的。

​ 对于不同的目的(例如对性能和大小的优化),Library Instance可以有不同的实现方式。

​ 在初始开发中,通常使用没有经过优化的Library Instance来降低开发风险。完成模块的基本功能后,可以进一步调整其大小和性能。

​ 在MdePkg中,为用户选择提供了许多可用的Library Instances,详细信息可以在其INF文件或MdePkg规范中找到。

举例:

​ 在MdePkg中,对于LibraryClass:BaseMemory的Library Instance:BaseMemoryLibOptDxe的实现,采用了寄存器操作内存的方式,获得了更好的性能表现。

​ 另一个例子是,在MdePkg中,LibraryInstance:PeiIoLibCpuIo通过使用CpuIo PPI的服务来实现IO的LibraryClass,减少了代码大小。

​ PCD会在Package的DEC文件中声明。当PCD的Value和DEC文件中的默认值一致时,这些PCD则不需要再DSC中再次赋值。

​ 在DSC中,PCD类型和值可以根据Platform要求进行配置。在DSC中,一个PCD的类型只允许是唯一的类型。如果DSC中没有对其进行指定,那么PCD的类型将和DEC中声明的类型保持一致。如果一个PCD支持多种PCD类型,那么其默认PCD类型是固定PCD类型。

4.3.1 PCD的类型

(1)Feature Flag PCD

​ 如果一个PCD被声明为PcdsFeatureFlag ,那么它只能是FeatureFlag PCD type或者BOOLEAN data type。如果Module需要使用本类PCD,则需要在INF的[FeaturePcd]中预先指定。

只有通过FeaturePcdGet接口才可以操作此种类型的PCD

示意:

(2)Fixed PCD

​ 如果一个PCD的Value在整个编译期间都是固定的,那么它的类型应设置为PcdsFixedAtBuild 。

当Module使用此类PCD时,它可以选择归属在==Module INF的[FixedPcd]或者[PCD]==中。

​ 此外,操作本类型的PCD,需要使用FixedPcdGet或者PcdGet接口。

(3)Patchable PCD

​ 如果一个PCD的Value在二进制Image中不固定(会被修改),它的类型应设置为PcdsPatchable 。在Module中使用此类PCD时,它可以分在==[FatchPcd]或者[PCD]==。

(4)Dynamic PCD

​ 如果PCD的Value在运行期间获得,那么它的类型应设置为Dynamic。如果一个Dynamic PCD是从Driver共享的PCD数据库取得Value,那么它的类型应该是PcdsDynamicDefault;如果一个Dynamic PCD和UEFI Variable相关,那么它的类型应该是PcdsDynamicHII。

​ 当在Module中使用Dynamic PCD,那么INF的 [PCD]部分需要注明。

​ 此外,操作Dynamic PCD只有通过PcdGet、PcdSet两个接口。

示例图:

​ 链接选项 (link option)

​ EDKII 编译系统提供了四种层次的override机制来实现Compiler Options的定制。

影响范围从大到小,依次是:Tool_def.txt,DSC(最为推荐,只修改了DSC文件),INF。

​ 这些Options可以通过指定顺序实现互相覆盖。

不同编译工具可选的编译器选项(compiler option)并不相同

Module INF示例:

DSC示例

​

​ 在DSC的==[Components]部分,为某个Module添加编译器选项(compiler option),则只对该Module==,且只在该DSC生效。

DSC [Components]示例

示例:

示例:

示例:

示例:

​ 如果在命令行上指定多次,则会按顺序使用每个工具链。

4.5.6 示例:Build Helloworld

​ 在build DEBUG文件夹中会创建以下文件:EFI Image、Intermediate Files、AutoGen.h、AutoGen.c、Module.map 文件

​ EDK II build工具根据所需的Module信息,为每个Module生成AutoGen.h和AutoGen.c文件。其中包括了依赖的pcd,Guid值和包含Module Entry Point相关的函数。

​ 这些AutoGen函数在ModuleEntryPoint库实例中被引用。对于每个Module, Entry Point函数首先调用AutoGen Code,然后进入Module functions。

​ Module.Map是由compiler tool生成的,用于列出该Module中所有函数及其相对地址。它们可用于在运行时定位Module函数地址。

AutoGen.c如图:

PcdDxe.map如图:

​ 在build DEUBG文件下,会出现ModuleName.efi 和ModuleName.rom

Option Rom INF示例:

4.6.1 常见build Module报错

$(WORKSPACE)\Conf\ TARGET .txt并更改“TARGET = DEBUG”作为调试提示。开发人员也可以使用命令行来覆盖该值,例如在调试提示中使用“build -b DEBUG”。

UefiDebugLibStdErr, PeiDxeDebugLibReportStatusCode。开发人员可以按实际要求在Package的DSC文件中,选择合适的DebugLib库实例。


讯享网

​ 开发人员可以根据已加载Module的基址和Map File来计算函数的内存地址。

(2)通过Variable

​ Variable是一对 key/Value,由标识信息加上属性(Key)和任意数据(Value)组成。Variables传递数据,主要为:存储平台实现的EFI环境、EFI OS Loader和在EFI环境中运行的其他应用之间的传递。

​ UEFI应用程序可以通过UEFI Runtime Services读写变量GetVariable()和SetVariable()。因为UEFI App必须在Dxe/UEFI驱动之后运行,不可缺少Variable Arch protocol。

​ 之后,UEFI Driver可能会被EFI_DRIVER_BINDING_PROTOCOL 调用,来对于一个指定的Hardware进行支持性测试。这项测试是为了确定一个driver是否支持一个给定的controller。

​ 该测试在不对controller引起负面影响的前提下,必须越快越好。Controller的大部分初始化都是在EFI_DRIVER_BINDING_PROTOCOL 服务的开始和结束时完成的。

UEFI Driver和DXE Driver的区别见第六节
2.1 UEFI Driver介绍
2.1.1 INF文件
​ UEFI Driver的INF file里,[Defines] 部分的Module TYPE必须指定为UEFI Driver。

​ UEFI Driver没有 [Depex] 的部分。因为它一直依赖于DXE架构下的protocols。为了实现这一点,UEFI Driver Entry Point库实例将所有DXE架构下的protocols的依赖关系附加到了Module Image的 [Depex] 部分。

示例:

(1)示例:

Global Variables

​ UEFI驱动可以使用Protocol访问其他Module产生的Protocol接口

(2)通过Variable

​ UEFI驱动可以通过UEFI Runtime Services读取和写入变量GetVariable()和SetVariable()。

​ 1.UEFI Driver不需要依赖Dependency来决定执行的顺序

​ 2.UEFI Driver必须可以被重复执行

​ 3.UEFI Driver不需要即时启动

​ 4.UEFI Driver支持硬件的热插拔(Hot-Plug)

​ 5.UEFI Driver支持软件的热插拔(Unload)

​ 6.UEFI Driver所有的Function都是Device(Handle)结合Driver(Protocol)

3.1.1 INF File

(1)对于一个物理平台来说,Module_Type必须是SEC,对于一个模拟平台来说,可以是SEC,也可以是USER_DEFINED

(2)对于IA32来说,入口一定是_ModuleEntryPoint

(3)对于安腾处理器家族平台,入口点是可配置的,例如SAMPLE_ENTRY。但是,这个入口点==应该添加到[BuildOptions]==部分,如下所示:

​ 强烈推荐PEI模块只做最小要求的工作来满足后续阶段的要求。PEI Foundation建立了所有PEI Module使用的PEI Service Table。

​ PEI阶段允许在Memory可用之前,执行C语言代码实现的PEI Module。这是通过配置CPU的资源,例如CPU data cache来实现内存栈。

FileHandle是正被调用文件的handle,PeiServices是PEI Services Table的间接指针

示例图:

​ EDKII 为PEI Modules提供了PEI Services Table Library,来获取PEI Service Table。除了从PEI Module的Entry Point中的输入函数来获取PEI Services Table指针。EDKII 还允许使用定义在PEI Services Table Pointer Library中的GetPeiServicesTablePointer() 来获取PEI Services Table指针。

​ 在EDKII 中,一个PEIM Module可以通过GUID调用 PeiServicesInstallPpi() ,来Publish自己的PPI Services到PPI database中。另一个PEIM Module可以根据GUID来调用PeiServicesLocatePpi() ,在PPI database中定位PPI Services。

(1)Installing a PPI

​ 如果一个Module A想要publish一个PPI Services的Template(假设其中包括三个API:interface1、2、3). 他可以通过使用PeiserciecesInstallPpi来Install 这个PPI Template。

示例:

(2)Locating a PPI

​ 如果Module B需要调用PPI Template提供的Interface2(),他可以通过使用下列代码来Locate。

​ 在EDKII 中,Hob Library为PEIMs和DXE Driver提供了通用的接口来使用HOBs。

动态PCD的值,这些值之前由DXE Driver设定。Get PCD的用法在附录A Dynamic PCD有介绍。

​

4.5 与DXE Module的通信
4.5.1 HOB
​ 通过使用Hand-Off Block, PEIMs可以将一些信息传递给DXE Foundation和DXE模块,例如在PEI阶段发现的内存信息。

​ 在EDK II中,Hob Library提供了一组接口来帮助构建Hob,例如BuildGuidHob ()。Hob库还为PEIMs和DXE Drivers提供了一组api来定位Hob。

PEIMs可以使用ReadOnlyVariable2 来获取Variables。

(2)当size为0时,调用GetVariable()来获取Variable的实际大小。

(3)为Variable分配内存空间

(4)再一次以实际大小调用GetVariable()

代码示例:

4.6 Boot Mode
​ 有时候,PEIMs需要确认boot mode(S3、S5等等),并且根据boot mode采取合适的举动。例如VariablePei Module在recovery boot path下时,将不会Install EFI ReadOnlyVariable2Ppi。

​ PEI Service Table提供了一系列的services来设置或者获取boot mode。PEI Service Library中相应的API为:SetBootMode() and GetBootMode() 。

get boot mode的示例:

​ 在代码的空间复杂性和Module的时间复杂性之间有这样的权衡:保持Modules的小还是保持代码路径的短。

​ PEIM 代码的数量和复杂性需要简化。例如:对于在Flash上运行的代码来说,需要避免很大的循环。

​ 当PEIM尝试将自己load到system memory并且再次运行时,它可以使用RegisterForShadow () 来实现。RegisterForShadow () 在Pei Service Table中。

​ 如果一个PEIM的Dependency是True,那么其可以立刻被dispatch。在扩展INF文件中,Dependency部分包含在[Depex]部分中。PPI dependency被PPI GUID定义。

​ 非UEFI驱动模型的驱动在DXE阶段早期执行。这些驱动是DXE Foundation产生所有要求服务的先决条件。

​ DXE驱动程序必须设计成不需要不可用的服务。考虑到这一限制,所有可能的工作都应该交由UEFI驱动程序完成。

UEFI Driver和DXE Driver的区别见第六节
5.1 INF 文件
​ DXE驱动程序需要扩展INF文件。INF文件的基本介绍请参见第二章。

​ DXE驱动的 [Defines] 部分应该按照如下修改:

​ 在下面的例子中(来自MdeModulePkg中的WatchDogTimerDxe驱动程序),如果protocol尚未安装,DXE驱动程序入口点将安装它的Architectural Protocol。

​ UEFI Boot Services, UEFI Runtime Services, and UEFI System Table在UEFI Spec中都有定义。DXE Services在PI中有定义。

​ DXE Driver可以通过下列Library Class提供的全局变量,检索这些tables。

如图:

​ 首先,要使用这些protocols,Module开发人员必须在INF文件中声明Module使用的protocols,然后写代码来使用这些protocols。

(1)下面的例子演示了DXE Driver如何产生一个protocol

(2)下面演示DXE Driver如何retrieve一个protocol并且调用这个API

​ DXE Driver可以通过UEFI Runtime Services提供的GetVariable() and SetVariable() 来读写Variable。这两个Services在DXE刚开始的时候并不可用。

​ 需要对易失环境Variables进行只读或者读写的DXE Drivers,必须在INF的dependency中中加入EFI_VARIABLE_ARCH_PROTOCOL 。

​ 需要对非易失环境Variable进行写操作的DXE Driver,必须在INF的dependency中中加入EFI_VARIABLE_WRITE_ARCH_PROTOCOL 。

​ 环境Variable 服务的完整实现在EFI_VARIABLE_ARCH_PROTOCOL and EFI_VARIABLE_WRITE_ARCH_PROTOCOL 安装之前不可用。

对Variable读写的Sample Code示例:

​ HobLib提供了一组api来构建和解析HOB列表。由于DXE驱动程序只读取HOB列表,所以DXE驱动程序的模块编写者可以专注于解析HOB列表的api。

(2)仅检索HOB列表中特定类型的第一个HOB(以CPU HOB为例)

(3)遍历HOB列表中的特定类型HOB(以CPU HOB为例)

(4)仅检索HOB列表中具有特定GUID的第一个GUIDed HOB

​

(5)在HOB列表中使用特定的GUID遍历GUIDed HOB

示例(只有在安装了列出的所有四种协议之后才能执行此驱动程序):

​ 在这种情况下,DXE驱动程序应该创建一个信号类型事件,当EFI OS Loader调用gBS->ExitBootServices()时通知该事件。

​ 此Event的通知功能不允许使用内存分配services,或者调用任何使用内存分配services的函数,并且应该只调用已知没有使用内存分配的函数services,因为这些services修改当前内存映射。

通知功能和事件注册模板代码如下:

​ DXE Foundation被认为是一个引导服务组件,所以当ExitBootServices() 被调用时,DXE Foundation也可以被发布。因此,runtime时的驱动程序可能不会使用任何UEFI Boot Services, DXE Services ,或者调用ExitBootServices()后引导服务驱动程序产生的服务。

​ DXE runtime driver在INF文件中将MODULE_TYPE定义DXE_RUNTIME_DRIVER。此外,因为DXE Runtime Driver在其生存周期中导致了

SetVirtualAddressMap() 。它可能需要为event EVT_SIGNAL_VIRTUAL_ADDRESS_CHANGE注册一个event handle。

示例:

​ DXE Runtime Driver创建的signal类型的Event所用到的通知函数不允许直接或者间接使用UEFI Boot Services、UEFI Console Services 或者 UEFI Protocol Services 。因为当调用SetVirtualAddressMap()之时,这些Services都将不可用。

​ 通常,DXE Runtime Driver创建的signal类型的Event所用到的通知函数使用

ConvertPointer() 来将指针从物理转换为虚拟。

通知函数和Event注册模板代码如下:

​ SMM初始化是SMM驱动程序初始化的阶段,它从调用直到驱动程序的入口点开始,并从驱动器的入口点返回。

​ SMM Runtime是SMM Driver初始化的阶段。这个阶段在驱动入口点返回以后。

示意图:

​ 在SMM Runtime运行期间,drivers可能不可以使用内核protocol services。有相关的SMST based services供Drivers使用。但是UEFI System Table和其他在boot services阶段之间安装的protocols可能并不一定可用。

​ 在SMM 初始化期间,UEFI Boot Services、UEFI Runtime Services、SMST-based services都是可用的。

​ 在SMM Driver初始化的过程中,SMM Driver可以使用两类protocol:UEFI protocol和SMM protocol。

​ UEFI Protocol指的是Install和discover时使用UEFI Boot Services的protocols。SMM Driver只有在初始化的过程中,才可以locate和使用UEFI Protocols。

​ SMM Protocols指的是使用System Management Services Table(SMST)来install和discover的protocols。

​ 在SMM Drivers初始化期间,SMM Drivers不允许使用UEFI Boot Services Exit() and ExitBootServices()。

​ 这些SMM Driver Runtime的特性,导致了关于UEFI Services用法的一些限制。

(1)在SMM Driver初始化期间locate的Interface和services,在SMM Driver Runtime期间不可以被调用或者引用。

(2)SMM Driver 初始化期间创建的 Events必须在 Driver Entry Point退出之前关闭。

​ DXE Driver是在编写驱动的时候主动寻找设备并且对其进行初始化;UEFI Driver则是系统服务自己根据设备寻找合适的驱动,然后对其进行初始化。前者一般在驱动运行的时候就直接完成。后者需要先对驱动进行注册,然后通过调用系统服务来完成初始化。

两种类型的示意图:

[Defines]
INF_VERSION = 0x00010005
BASE_NAME = DxeDriverInBds
FILE_GUID = 0-0174-498F-A2F9-08F3A5363F84
MODULE_TYPE = UEFI_DRIVER
VERSION_STRING = 1.0
ENTRY_POINT = DxeDriverEntry
1
2
3
4
5
6
7
6.1.2 UEFI Driver
​ UEFI Driver只是安装了一个Protocol。以SnpDxe这个Module为例,gSimpleNetworkDriverBinding这个Protocol就是这个设备在DXE阶段安装的Protocol。所有符合UEFI Driver Model的驱动都会安装一个类似的Protocol。

​ 简而言之,UEFI Driver就是在DXE阶段安装了这样的Protocol,然后在 gBS -> Connect Controller的时候。首先将会执行 xxSupported()函数,根据 EFI SUCCESS返回值继续执行 xxStart()函数,该 xxStart()函数中就实现了设备初始化的代码。

SnpDXE.inf的 xxSupported()函数和主要流程如下:

当扫描的这个设备的时候(设备用Controller表示),先判断它是否已经Install了DevicePathProtocol,没有就表示这个设备还没有准备好(或者说不是设备),后面的xxxStart()不用执行;

然后判断NetworkInterfaceIdentifierProtocol是否安装,这个是网卡驱动一定会装的Protocol,Snp驱动底层的操作需要依赖于它,所以一定要安装,如果没有就不会执行后面的操作;

判断NetworkInterfaceIdentifierProtocol是否满足要求,如果不满足则不会执行xxxStart()函数。

​ 如果以上条件都满足,就可以认为该设备是一个网卡,然后这个驱动就会被执行(执行xxxStart()函数),而之前获取到的DevicePathProtocol和NetworkInterfaceIdentifierProtocol就会成为操作正确设备的基础。

EFI_STATUS
EFIAPI
SimpleNetworkDriverSupported (
IN EFI_DRIVER_BINDING_PROTOCOL *This,
IN EFI_HANDLE Controller,
IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath
)
{
EFI_STATUS Status;
EFI_NETWORK_INTERFACE_IDENTIFIER_PROTOCOL *NiiProtocol;
PXE_UNDI *Pxe;

Status = gBS->OpenProtocol (
Controller,
&gEfiDevicePathProtocolGuid,
NULL,
This->DriverBindingHandle,
Controller,
EFI_OPEN_PROTOCOL_TEST_PROTOCOL
);
if (EFI_ERROR (Status)) {
return Status;
}

Status = gBS->OpenProtocol (
Controller,
&gEfiNetworkInterfaceIdentifierProtocolGuid_31,
(VOID ) &NiiProtocol,
This->DriverBindingHandle,
Controller,
EFI_OPEN_PROTOCOL_BY_DRIVER
);

if (EFI_ERROR (Status)) {
if (Status == EFI_ALREADY_STARTED) {
DEBUG ((EFI_D_INFO, “Support(): Already Started. on handle %p\n”, Controller));
}
return Status;
}

DEBUG ((EFI_D_INFO, “Support(): UNDI3.1 found on handle %p\n”, Controller));

//
// check the version, we don’t want to connect to the undi16
//
if (NiiProtocol->Type != EfiNetworkInterfaceUndi) {
Status = EFI_UNSUPPORTED;
goto Done;
}
//
// Check to see if !PXE structure is valid. Paragraph alignment of !PXE structure is required.
//
if ((NiiProtocol->Id & 0x0F) != 0) {
DEBUG ((EFI_D_NET, “\n!PXE structure is not paragraph aligned.\n”));
Status = EFI_UNSUPPORTED;
goto Done;
}

Pxe = (PXE_UNDI *) (UINTN) (NiiProtocol->Id);

//
// Verify !PXE revisions.
//
if (Pxe->hw.Signature != PXE_ROMID_SIGNATURE) {
DEBUG ((EFI_D_NET, “\n!PXE signature is not valid.\n”));
Status = EFI_UNSUPPORTED;
goto Done;
}

if (Pxe->hw.Rev < PXE_ROMID_REV) {
DEBUG ((EFI_D_NET, “\n!PXE.Rev is not supported.\n”));
Status = EFI_UNSUPPORTED;
goto Done;
}

if (Pxe->hw.MajorVer < PXE_ROMID_MAJORVER) {

DEBUG ((EFI_D_NET, "\n!PXE.MajorVer is not supported.\n")); Status = EFI_UNSUPPORTED; goto Done; 

讯享网

} else if (Pxe->hw.MajorVer == PXE_ROMID_MAJORVER && Pxe->hw.MinorVer < PXE_ROMID_MINORVER) {
DEBUG ((EFI_D_NET, “\n!PXE.MinorVer is not supported.”));
Status = EFI_UNSUPPORTED;
goto Done;
}
//
// Do S/W UNDI specific checks.
//
if ((Pxe->hw.Implementation & PXE_ROMID_IMP_HW_UNDI) == 0) {
if (Pxe->sw.EntryPoint < Pxe->sw.Len) {
DEBUG ((EFI_D_NET, “\n!PXE S/W entry point is not valid.”));
Status = EFI_UNSUPPORTED;
goto Done;
}

讯享网if (Pxe->sw.BusCnt == 0) { DEBUG ((EFI_D_NET, "\n!PXE.BusCnt is zero.")); Status = EFI_UNSUPPORTED; goto Done; } 

}

Done:
gBS->CloseProtocol (
Controller,
&gEfiNetworkInterfaceIdentifierProtocolGuid_31,
This->DriverBindingHandle,
Controller
);

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
6.2 两种驱动的开始处
6.2.1 DXE Driver
​ 驱动被调用的基本函数是LoadImage()和StartImage(),这两个函数都是Boot Service,所以可以在DXE和BDS阶段的大部分地方调用。

​ DxeMain.c里面的DxeMain()函数,其中的CoreDispatcher()就是用来执行各个驱动的,除非自己写代码,否则DXE驱动都会在这个位置执行。

do {

// // Loop through the sorted Driver Binding Protocol Instances in order, and see if // any of the Driver Binding Protocols support the controller specified by // ControllerHandle. // DriverBinding = NULL; DriverFound = FALSE; for (Index = 0; (Index < NumberOfSortedDriverBindingProtocols) && !DriverFound; Index++) { if (SortedDriverBindingProtocols[Index] != NULL) { DriverBinding = SortedDriverBindingProtocols[Index]; PERF_START (DriverBinding->DriverBindingHandle, "DB:Support:", NULL, 0); Status = DriverBinding->Supported( DriverBinding, ControllerHandle, RemainingDevicePath ); PERF_END (DriverBinding->DriverBindingHandle, "DB:Support:", NULL, 0); if (!EFI_ERROR (Status)) { SortedDriverBindingProtocols[Index] = NULL; DriverFound = TRUE; // // A driver was found that supports ControllerHandle, so attempt to start the driver // on ControllerHandle. // PERF_START (DriverBinding->DriverBindingHandle, "DB:Start:", NULL, 0); Status = DriverBinding->Start ( DriverBinding, ControllerHandle, RemainingDevicePath ); PERF_END (DriverBinding->DriverBindingHandle, "DB:Start:", NULL, 0); if (!EFI_ERROR (Status)) { // // The driver was successfully started on ControllerHandle, so set a flag // OneStarted = TRUE; } } } } 

} while (DriverFound);

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
四、附录
1.Dynamic PCD
​ Dynamic类型的PCD用来动态配置或者设置值。相比之下,Static类型的PCD如FeatureFlag, FixedPcd, PatchablePcd等等在build时已经在最后生成的FD image中被固定了。

​ Dynamic 决定意味着下列三种情况中的一种。

(1)PCD 设定值由Driver在执行过程中产生和使用。

(2)PCD 设定值可由用户在setup中配置

(3)PCD 设定值由平台OEM供应商在指定区域中产生。

​ 在编译平台,编译工具将PcdSampleDynamicPcd翻译为参数 Token Space Guid:Token Number。

​ [PcdsDynamicDefault]在平台DSC文件中,被作为此类型的PCD的名字。[PcdsDynamicExDefault]用于dynamicEx类型的pcd。

​ 在PEI阶段,这个PCD值可以被获得但是不可以被设置,因为这个Variable区域是只读的。

​ [PcdsDynamicHii]被用作平台DSC文件中这种类型的PCD的节名。

​ [pcdsdynamicexhibit]表示PCD的dynamicEx类型。

小讯
上一篇 2025-01-17 07:43
下一篇 2025-01-19 18:38

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/79771.html