UEFI开发——调用一个自己编写的protocol
迪丽瓦拉
2025-05-30 05:14:05
0

编写一个protocol并调用分三个部分,定义一个protocol,安装这个protocol,使用这个protocol。
源码下载:https://download.csdn.net/download/mao0514/87588583
首先列出我的工程目录:
D:\Mywork\edk2\MdeModulePkg\Application\myProtocol
UEFIStart是我创建的文件夹,在UEFIStart下有两个文件夹:

   分别存放protocol的安装代码和使用代码,每个文件夹有一个.c文件和.inf文件。**而定义protocol的文件在G:\edk2-UDK2017\Nt32Pkg\Include\Protocol下,是一个.h文件(Compare.h):**同样,对于工程文件的类型比如.inf、.dec、.dsc等文件的作用也不多说,参考《UEFI原理与编程》。

1.定义一个protocol
代码:

#ifndef UEFIMAIN_COMPARE_PROTOCOL_H
#define UEFIMAIN_COMPARE_PROTOCOL_H

#include

#define EFI_CPMPARE_PROTOCOL_GUID
{0xee7ba45e, 0x9642, 0x4a97, {0x83, 0xc3, 0x30, 0xeb, 0xed, 0x3f, 0x9d, 0xd6}} //定义这个protocol的GUID

typedef struct _EFI_COMPARE_PROTOCOL EFI_COMPARE_PROTOCOL;

typedef EFI_STATUS (EFIAPI *COMPARE)( //定义一个函数指针,包括EFI_COMPARE_PROTOCOL类型的指针和两个要比较大小的数
IN EFI_COMPARE_PROTOCOL *This,
IN UINT8 a,
IN UINT8 b
);

struct _EFI_COMPARE_PROTOCOL { //定义这个protocol的结构体,因为只实现比较大小,所以成员只有一个函数指针类型的成员
COMPARE compare;
};

extern EFI_GUID gEfiCompareProtocolGuid; //唯一的protocol,后面也会提到

#endif

   在Compare.h文件中extern EFI_GUID gEfiCompareProtocolGuid;这一句的gEfiCompareProtocolGuid是在Nt32Pkg的.dec文件中的[Protocols]中声明的,内容和Compare.h文件中的值一样:GUID的值我是用VS2013自带的生成工具生成的,必须在该目录下打开,如果光把guidgen.exe移到桌面或其他地方会出错。每个.inf文件也要有guid,也可以用这个生成。我之所以直接放在Nt32Pkg下面是因为我对工程文件还不熟悉,Nt32Pkg下面有现成的.dec、.dsc、.fdf文件,我只需要向这些文件中添加必要的内容即可,具体什么内容后面会指出(比如向.dec文件中的[Protocols]添加gEfiCompareProtocolGuid的声明)。

2.安装protocol
代码:

#include
#include
#include
#include

#include

EFI_STATUS EFIAPI Compare(IN EFI_COMPARE_PROTOCOL *This,IN UINT8 a,IN UINT8 b) //protocol要实现的功能
{
DEBUG((EFI_D_ERROR, “The Max Number is: %d\n”,(a>b?a:b)));
return EFI_SUCCESS;
}

EFI_STATUS EFIAPI
ProtocolInstallerEntry(
IN EFI_HANDLE ImageHandle,
IN EFI_SYSTEM_TABLE *SystemTable
)
{
EFI_STATUS Status;
EFI_COMPARE_PROTOCOL *Protocol;

Protocol = AllocatePool(sizeof(EFI_COMPARE_PROTOCOL));
if(NULL == Protocol){DEBUG((EFI_D_ERROR, "[Compare][%s][%d]:Out of resource.",__FUNCTION__, __LINE__));return EFI_OUT_OF_RESOURCES;
}Protocol->compare = Compare;Status = gBS->InstallProtocolInterface(&ImageHandle,&gEfiCompareProtocolGuid,EFI_NATIVE_INTERFACE,Protocol
);if(EFI_ERROR(Status)){DEBUG((EFI_D_ERROR, "[Compare]Install EFI_COMPARE_PROTOCOL failed. - %d\n", Status));FreePool(Protocol);return Status;
}return EFI_SUCCESS;

}

   安装protocol调用两个函数(说函数也行,接口也行,反正就是一个有功能的东西),在这里我把它的函数实现列举出来:AllocatePool

/**
Allocates a buffer of type EfiBootServicesData.

Allocates the number bytes specified by AllocationSize of type EfiBootServicesData and returns a
pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is
returned. If there is not enough memory remaining to satisfy the request, then NULL is returned.

@param AllocationSize The number of bytes to allocate.

@return A pointer to the allocated buffer or NULL if allocation fails.

*/
VOID *
EFIAPI
AllocatePool (
IN UINTN AllocationSize
)
{
return (VOID
) malloc (AllocationSize);
}

   InstallProtocolInterface是一个函数指针类型: EFI_INSTALL_PROTOCOL_INTERFACE InstallProtocolInterface;EFI_INSTALL_PROTOCOL_INTERFACE这个函数指针的声明如下:

//
// Protocol handler functions
//
typedef enum {
EFI_NATIVE_INTERFACE
} EFI_INTERFACE_TYPE;

typedef
EFI_BOOTSERVICE
EFI_STATUS
(EFIAPI *EFI_INSTALL_PROTOCOL_INTERFACE) (
IN OUT EFI_HANDLE * Handle,
IN EFI_GUID * Protocol,
IN EFI_INTERFACE_TYPE InterfaceType,
IN VOID *Interface
);

   还有两个函数DEGBUG和FreePool我也列举出来:DEGBUG

//
// DEBUG((DebugLevel, “format string”, …)) - if DebugLevel is active do
// the a debug print.
//
#define DEBUG(arg) EfiDebugPrint arg

   这个函数本来是输出错误信息的,但是我为了方便,就调用它显示我的结果,其中EfiDebugPrint 的定义是:

VOID
EfiDebugPrint (
IN UINTN ErrorLevel,
IN CHAR8 *Format,

)

   FreePool

/**
Frees a buffer that was previously allocated with one of the pool allocation functions in the
Memory Allocation Library.

Frees the buffer specified by Buffer. Buffer must have been allocated on a previous call to the
pool allocation services of the Memory Allocation Library. If it is not possible to free pool
resources, then this function will perform no actions.

If Buffer was not allocated with a pool allocation function in the Memory Allocation Library,
then ASSERT().

@param Buffer Pointer to the buffer to free.

**/
VOID
EFIAPI
FreePool (
IN VOID *Buffer
)
{
free ((void *) Buffer);
}

   还有就是,调用的函数要声明它的头文件,要找到函数的头文件。

2.使用Protocol
#include
#include
#include

#include

EFI_STATUS EFIAPI ProtocolUserEntry(
IN EFI_HANDLE ImageHandle,
IN EFI_SYSTEM_TABLE *SystemTable
)
{
EFI_STATUS Status;
EFI_COMPARE_PROTOCOL *Protocol;

Status = gBS->LocateProtocol(&gEfiCompareProtocolGuid, NULL, (VOID **)&Protocol);
if(EFI_ERROR(Status)){DEBUG((EFI_D_ERROR, "[BENI]Locate EFI_COMPARE_PROTOCOL failed. - %r\n",Status));return Status;
}Status = Protocol->compare(Protocol,5,9);
if(EFI_ERROR(Status)){DEBUG((EFI_D_ERROR, "[BENI]Protocol->Compare failed. - %r\n", Status));return EFI_SUCCESS;
}return EFI_SUCCESS;

}

   用LocateProtocol定位到protocol,然后调用,这里我给compare传的参数是5和9。其中LocateProtocol是EFI_LOCATE_PROTOCOL LocateProtocol;EFI_LOCATE_PROTOCOL是个函数指针:

typedef
EFI_BOOTSERVICE11
EFI_STATUS
(EFIAPI *EFI_LOCATE_PROTOCOL) (
EFI_GUID * Protocol,
VOID *Registration, OPTIONAL
VOID **Interface
);

   这些做完了以后还要配置Nt32Pkg的.dec、.dsc、.fdf文件,.dec文件已经说过了,在.dsc文件中,要在[Components]下添加:Nt32Pkg/UEFIStart/ProtocolInstaller/ProtocolInstaller.infNt32Pkg/UEFIStart/ProtocolUser/ProtocolUser.inf在.fdf文件中,要在DXE Phase modules下添加:INF Nt32Pkg/UEFIStart/ProtocolInstaller/ProtocolInstaller.infINF Nt32Pkg/UEFIStart/ProtocolUser/ProtocolUser.inf

3.运行结果

   因为我写的是UEFI_DRIVER所以要用load命令加载。比较5和9的大小,并将结果打印出来。在写protocol的过程中遇到了很多问题,其中编写.inf文件遇到的问题最多,原因还是因为我对.inf文件不是很了解,以后会继续学习,加油。附上两个文件的.inf:①ProtocolInstaller.inf

[Defines]
INF_VERSION = 0x00010005
BASE_NAME = ProtocolInstaller
FILE_GUID = 8D952513-D3B5-43C7-87DF-CD3B382D65F7
MODULE_TYPE = UEFI_DRIVER
VERSION_STRING = 1.0
ENTRY_POINT = ProtocolInstallerEntry

[Sources.common]
ProtocolInstaller.c

[Packages]

Nt32Pkg/Nt32Pkg.dec
MdePkg/MdePkg.dec

[LibraryClasses]

UefiDriverEntryPoint
UefiBootServicesTableLib
MemoryAllocationLib
DebugLib

[Protocols]

gEfiCompareProtocolGuid

[Depex]
TRUE

   ②ProtocolUser.inf

[Defines]
INF_VERSION = 0x00010005
BASE_NAME = ProtocolUser
FILE_GUID = 16BEFBED-60DC-4EA2-8E81-A3430A6CD6D5
MODULE_TYPE = UEFI_DRIVER
VERSION_STRING = 1.0
ENTRY_POINT = ProtocolUserEntry

[Sources.common]
ProtocolUser.c

[Packages]

Nt32Pkg/Nt32Pkg.dec
MdePkg/MdePkg.dec

[LibraryClasses]
UefiDriverEntryPoint
UefiBootServicesTableLib
DebugLib

[Protocols]
gEfiCompareProtocolGuid

[Depex]
TRUE

在这里插入图片描述

相关内容

热门资讯

linux入门---制作进度条 了解缓冲区 我们首先来看看下面的操作: 我们首先创建了一个文件并在这个文件里面添加了...
C++ 机房预约系统(六):学... 8、 学生模块 8.1 学生子菜单、登录和注销 实现步骤: 在Student.cpp的...
A.机器学习入门算法(三):基... 机器学习算法(三):K近邻(k-nearest neigh...
数字温湿度传感器DHT11模块... 模块实例https://blog.csdn.net/qq_38393591/article/deta...
有限元三角形单元的等效节点力 文章目录前言一、重新复习一下有限元三角形单元的理论1、三角形单元的形函数(Nÿ...
Redis 所有支持的数据结构... Redis 是一种开源的基于键值对存储的 NoSQL 数据库,支持多种数据结构。以下是...
win下pytorch安装—c... 安装目录一、cuda安装1.1、cuda版本选择1.2、下载安装二、cudnn安装三、pytorch...
MySQL基础-多表查询 文章目录MySQL基础-多表查询一、案例及引入1、基础概念2、笛卡尔积的理解二、多表查询的分类1、等...
keil调试专题篇 调试的前提是需要连接调试器比如STLINK。 然后点击菜单或者快捷图标均可进入调试模式。 如果前面...
MATLAB | 全网最详细网... 一篇超超超长,超超超全面网络图绘制教程,本篇基本能讲清楚所有绘制要点&#...
IHome主页 - 让你的浏览... 随着互联网的发展,人们越来越离不开浏览器了。每天上班、学习、娱乐,浏览器...
TCP 协议 一、TCP 协议概念 TCP即传输控制协议(Transmission Control ...
营业执照的经营范围有哪些 营业执照的经营范围有哪些 经营范围是指企业可以从事的生产经营与服务项目,是进行公司注册...
C++ 可变体(variant... 一、可变体(variant) 基础用法 Union的问题: 无法知道当前使用的类型是什...
血压计语音芯片,电子医疗设备声... 语音电子血压计是带有语音提示功能的电子血压计,测量前至测量结果全程语音播报࿰...
MySQL OCP888题解0... 文章目录1、原题1.1、英文原题1.2、答案2、题目解析2.1、题干解析2.2、选项解析3、知识点3...
【2023-Pytorch-检... (肆十二想说的一些话)Yolo这个系列我们已经更新了大概一年的时间,现在基本的流程也走走通了,包含数...
实战项目:保险行业用户分类 这里写目录标题1、项目介绍1.1 行业背景1.2 数据介绍2、代码实现导入数据探索数据处理列标签名异...
记录--我在前端干工地(thr... 这里给大家分享我在网上总结出来的一些知识,希望对大家有所帮助 前段时间接触了Th...
43 openEuler搭建A... 文章目录43 openEuler搭建Apache服务器-配置文件说明和管理模块43.1 配置文件说明...