一、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类型。

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