本文主要是介绍UEFI开发——编写一个简单的PPI，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！
PEI阶段是由一个个的PEIM实现的，而PPI是PEIM之间互相调用的接口。简单来说，PPI只是一个接口，接口里面有成员函数，想调用某个函数就必须通过该接口。
PPI通过PPI描述符来描述其特性，PPI描述符是一个数据结构，定义如下：
typedef struct {//UINTN是一个无符号的整数，Flags是一系列诸如EFI_PEI_PPI_DESCRIPTOR_***的组合UINTN Flags;//接口的名字，即它的GUIDEFI_GUID *Guid;//指向PPI的指针，包含安装服务的信息VOID *Ppi;
} EFI_PEI_PPI_DESCRIPTOR;在利用PPI的过程中，有个几个重要的PPI服务：
InstallPpi（）：安装PPI到PEI foundation
LocatePpi（）：根据PPI名字GUID从PEI foundation中找到Interface
NotifyPpi（）：PPI里的function不会再派发时就执行，会有一个判定条件，通知系统这个PPI会在某个PPI被安装时才执行。
1、编写一个InstallPPI的源文件：
该模块通过PeiServicesInstallPpi注册接口，以提供服务
/**This service enables a given PEIM to register an interface into the PEI Foundation.@param PpiList A pointer to the list of interfaces that the caller shall install.@retval EFI_SUCCESS The interface was successfully installed.@retval EFI_INVALID_PARAMETER The PpiList pointer is NULL.@retval EFI_INVALID_PARAMETER Any of the PEI PPI descriptors in the list do not have theEFI_PEI_PPI_DESCRIPTOR_PPI bit set in the Flags field.@retval EFI_OUT_OF_RESOURCES There is no additional space in the PPI database.**///使特定的PEIM向PEI foundation注册接口
EFI_STATUS
EFIAPI
PeiServicesInstallPpi (IN CONST EFI_PEI_PPI_DESCRIPTOR *PpiList //指向调用者应安装的接口列表的指针);所提供的服务由EFI_PEI_PPI_DESCRIPTOR这个数据结构通过PEIM向PEI foundation进行描述，这个数据结构的原型为
// The data structure through which a PEIM describes available services to the PEI Foundation.
typedef struct {// This field is a set of flags describing the characteristics of this imported table entry.// All flags are defined as EFI_PEI_PPI_DESCRIPTOR_***, which can also be combined into one.UINTN Flags;// The address of the EFI_GUID that names the interface.EFI_GUID *Guid;// A pointer to the PPI. It contains the information necessary to install a service.VOID *Ppi;
} EFI_PEI_PPI_DESCRIPTOR;完整的 MyHelloWorldInstallPPI模块的源文件为：
#include <uefi.h>
#include <Library/UefiLib.h>
#include <Library/BaseLib.h>
#include <Library/DebugLib.h>
#include <Library/BaseMemoryLib.h>
#include <Library/UefiDriverEntryPoint.h>
#include <Library/PeimEntryPoint.h>
#include <Library/PeiServicesLib.h>
#include <Library/PeiServicesTablePointerLib.h>
#include <Pi/PiHob.h>
#include <Pi/PiPeiCis.h>EFI_GUID gMyHelloWorldPEIGUID = { 0xbdb38129, 0x4d65, 0x39f4, { 0x72, 0x12, 0x68, 0xcf, 0x5a, 0x19, 0xa, 0xf8 }};//定义了一个DEBUG_ERROR级别的信息打印函数，
EFI_STATUS
EFIAPI
PrintHelloMsg (IN CHAR16 * Msg //定义了一个输入参数，类型为CHAR16的指针)
{DEBUG ((EFI_D_ERROR, "[MyHelloWorldPPI] PrintHelloMsg : %s \n",Msg));return EFI_SUCCESS;
}/*
typedef的作用是给已有的数据类型或结构体定义一个新的名称
函数指针：指向函数的指针变量
int maxValue (int a, int b) {return a > b ? a : b;
} int (*p)(int, int) = NULL; //定义一个与maxValue兼容的指针
p = maxValue;
p(20, 45); //通过指针调用
*/
typedef EFI_STATUS (EFIAPI * PRINTMSG)(CHAR16 *Msg);//给已有的数据类型定义了一个新的名称PRINTMSG，原来的数据类型为函数指针类型EFI_STATUS (EFIAPI *)(CHAR16* Msg)
typedef struct _EFI_HELLOWORLD_PROTOCOL {PRINTMSG PrintMsg;
}EFI_HELLOWORLD_PROTOCOL;//定义了一个结构体，结构体成员为函数指针PrintMsg，并使用typedef将这个结构体的别名为EFI_HELLOWORLD_PROTOCOL//ppi实例
EFI_HELLOWORLD_PROTOCOL mHelloWorldPpi = {PrintHelloMsg
};//定义了一个EFI_HELLOWORLD_PROTOCOL类型的全局变量，并赋初值为PrintHelloMsg(即指向上面的打印函数)EFI_PEI_PPI_DESCRIPTOR mPpiListCodePpi = { //EFI_PEI_PPI_DESCRIPTOR是一个数据结构，可以向PEIfoundation描述能够提供的服务(EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST), //EFI_PEI_PPI_DESCRIPTOR_***这样flag的组合，| 表示按位或&gMyHelloWorldPEIGUID, //GUID, PPI的名字&mHelloWorldPpi //ppi实例
};//在这里定义了一个结构体变量mPpiListCodePpi，并进行初始化//安装PPI，指的是把一个或多个PPI注册到PEI foundation中
EFI_STATUS
EFIAPI
MyHelloWorldInstallPPIEntry(IN EFI_PEI_FILE_HANDLE FileHandle,IN CONST EFI_PEI_SERVICES **PeiServices //指向EFI_PEI_SERVICES table的间接指针
)
{EFI_STATUS Status = EFI_SUCCESS;DEBUG ((EFI_D_ERROR, "[MyHelloWorldPPI] MyHelloWorldInstallPPIEntry Start..\n"));PeiServicesInstallPpi (&mPpiListCodePpi);DEBUG ((EFI_D_ERROR, "[MyHelloWorldPPI] MyHelloWorldInstallPPIEntry End..\n"));return Status;
}
2、编写InstallPPI的inf文件
3、编写LocatePPI的源文件：
PeiServicesLocatePpi服务的作用让PEIM发现接口的给定实例，其原型为：
EFI_STATUS
EFIAPI
PeiServicesLocatePpi (IN CONST EFI_GUID *Guid, //指向需要被查找的GUIDIN UINTN Instance, //所需接口的第几个实例IN OUT EFI_PEI_PPI_DESCRIPTOR **PpiDescriptor OPTIONAL, //指向EFI_PEI_PPI_DESCRIPTOR实例的指针IN OUT VOID **Ppi //指向接口实例的指针);#include <uefi.h>
#include <Library/UefiLib.h>
#include <Library/BaseLib.h>
#include <Library/DebugLib.h>
#include <Library/BaseMemoryLib.h>
#include <Library/UefiDriverEntryPoint.h>
#include <Library/PeimEntryPoint.h>
#include <Library/PeiServicesLib.h>
#include <Library/PeiServicesTablePointerLib.h>
#include <Pi/PiHob.h>EFI_GUID gMyHelloWorldPEIGUID = { 0xbdb38129, 0x4d65, 0x39f4, { 0x72, 0x12, 0x68, 0xcf, 0x5a, 0x19, 0xa, 0xf8 }};typedef EFI_STATUS (EFIAPI * PRINTMSG)(CHAR16 *Msg);
typedef struct _EFI_HELLOWORLD_PROTOCOL {PRINTMSG PrintMsg;
}EFI_HELLOWORLD_PROTOCOL;//ShellCEntryLib call user interface ShellAppMain
EFI_STATUS
EFIAPI
MyHelloWorldLocatePPIEntry(IN EFI_PEI_FILE_HANDLE FileHandle,IN CONST EFI_PEI_SERVICES **PeiServices
)
{EFI_STATUS Status = EFI_SUCCESS;EFI_HELLOWORLD_PROTOCOL *mHelloWorldPpi = NULL;DEBUG ((EFI_D_ERROR, "[MyHelloWorldPPI] MyHelloWorldLocatePPIEntry Locate PPI Start..\n"));
//定位PPI接口Status = PeiServicesLocatePpi (&gMyHelloWorldPEIGUID, //我们要查找的PPI的GUID0,NULL,(VOID **)&mHelloWorldPpi //指向PPI实例指针的指针);if (EFI_ERROR(Status)){DEBUG ((EFI_D_ERROR, "[MyHelloWorldPPI] MyHelloWorldLocatePPIEntry Locate PPI Fail..%r\n",Status));return Status;}mHelloWorldPpi->PrintMsg(L"2019 CSDN Locate PPI Hello World ...\n");DEBUG ((EFI_D_ERROR, "[MyHelloWorldPPI] MyHelloWorldLocatePPIEntry Locate PPI End..\n"));return Status;
}
4、编写LocatePPI的inf文件
编译整个包，并将生成的OVMF.fd文件加载到qemu中，其
注意这里的模块是PEIM，无法在qemu里运行其二进制文件
制作运行qemu的脚本，新建一个qemurun.bat文件，将以下内容保存在其中：
@echo off
chcp 65001
"E:\Program Files\qemu\qemu-system-x86_64.exe" -bios "E:\UEFIWorkSpace\Build\OvmfX64\DEBUG_VS2017\FV\OVMF.fd" -M pc -m 256 -cpu "qemu64" -boot order=dc -serial stdio -net none -usbdevice disk:HDD_BOOT.img（注：根据自己的qemu的安装位置和fd文件的位置进行更改）
然后运行命令：
qemurun.bat | findstr MyHelloWorldPPI其运行结果如下
E:\UEFIWorkSpace\edk2>qemurun.bat | findstr MyHelloWorldPPI
WARNING: Image format was not specified for 'HDD_BOOT.img' and probing guessed raw.Automatically detecting the format is dangerous for raw images, write operations on block 0 will be restricted.Specify the 'raw' format explicitly to remove the restrictions.
[MyHelloWorldPPI] MyHelloWorldInstallPPIEntry Start..
[MyHelloWorldPPI] MyHelloWorldInstallPPIEntry End..
[MyHelloWorldPPI] MyHelloWorldLocatePPIEntry Locate PPI Start..
[MyHelloWorldPPI] PrintHelloMsg : 2024 CSDN Locate PPI Hello World ...
[MyHelloWorldPPI] MyHelloWorldLocatePPIEntry Locate PPI End..
结果总结：
MyHelloWorldInstallPPI模块通过PeiServicesInstallPpi提供了mPpiListCodePpi服务（通过 EFI_PEI_PPI_DESCRIPTOR来指定具体的实例），而MyHelloWorldLocatePPI模块通过PeiServicesLocatePpi获取了mPpiListCodePpi对象，通过访问对象的成员函数即可完成对PEIM驱动MyHelloWorldInstallPPI资源的访问。
（注意，要想在运行的时候输出以上DEBUG信息，需要在编译包的时候加上DEBUG_ON_SERIAL_PORT）
参考博客：https://blog.csdn.net/xiaopangzi313/article/details/89602882
这篇关于UEFI开发——编写一个简单的PPI的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！
