我的BIOS之行-hob的使用
Posted AlexKing阁下
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了我的BIOS之行-hob的使用相关的知识,希望对你有一定的参考价值。
HOB(hand off block)简介
有些时候,我们需要将一些information从PEI阶段传递到DXE阶段,那么这个时候我们就需要hob当做桥梁来给我们进行传递了。总的来说,PEI生产HOB,DXE消费HOB,在这里需要注意HOB只有在PEI阶段是可修改的,在DXE阶段是只读的,每一个Block都有自己的GUID与Struct
运作模式
当PEI阶段的module需要传递信息给DXE时,会Call PEI Service去建立一个HOB的block,并加载在HOB的list上。
HOB使用的实例
在这里我是将上一章所使用的setup的item选项联系起来,在PEI阶段获取item的值,并建立HOB,将item的值进行保存,然后由DXE阶段获取。
具体需要看源码的请移步我的github的homework项目
HOB在PEI阶段
新建pei文件并获取item的值
在sdl文件中加入
TOKEN
Name = "HomeWorkPeim_INF_SUPPORT"
Value = "1"
Help = "Main switch to enable HomeWorkDxe support in Project"
TokenType = Boolean
Token = "HomeWork_SUPPORT" "=" "1"
End
INFComponent
Name = "HomeWorkPeim"
File = "Pei/HomeWorkPeim.inf"
Package = "Homework"
ModuleTypes = "PEIM"
Token = "HomeWorkPeim_INF_SUPPORT" "=" "1"
End
这样就已经将PEI的inf文件定义好了,此时要做的是在module的目录中建立Pei目录并在其中新建HomeWorkPeim.c/HomeWorkPeim.inf
并在inf文件中
[Defines]
INF_VERSION = 0x00010015
BASE_NAME = HomeWorkPeim
FILE_GUID = d133c000-7911-4e7f-abff-71f14f3337a8
MODULE_TYPE = PEIM
VERSION_STRING = 1.0
ENTRY_POINT = HomeWorkPeimEntryPoint
定义这个PEI文件的name 与入口参数,还有一些guid,依赖等,这个在后续专门出博客来讲解inf的一些定义,这里主要讲hob,我就不描述了。
注意:这里的入口函数一定要与C文件对应
同时你需要在module建立一个homework.h文件用于建立hob所需要的结构体与GUID
#define HOMEWORK_HOB_GUID \\
0x6ff0434a, 0x9598, 0x42cc, 0xb7, 0x38, 0xad, 0x17, 0x55, 0x48, 0x42, 0x9c
typedef struct
EFI_HOB_GUID_TYPE EfiHobGuidType;
UINT8 homeworkdata;
HOMEWORK_HOB;
如前面所说,hob就是通过guid来获取相关的信息,那么这个GUID就必须可以让PEI阶段的文件抓取的到,有可以让DXE文件抓取的到。
首先要做的是讲setup的值获取到,此时你需要用到的是gEfiPeiReadOnlyVariable2PpiGuid这个PPI。至于什么是PPI请移步我前面发布的一些博客
EFI_GUID SetupGuid = SETUP_GUID;
EFI_PEI_READ_ONLY_VARIABLE2_PPI *ReadOnlyVariable;
UINTN VariableSize;
SETUP_DATA SetupData;
Status = PeiServicesLocatePpi(&gEfiPeiReadOnlyVariable2PpiGuid, 0, NULL, &ReadOnlyVariable);
// ASSERT_EFI_ERROR(Status);
VariableSize = sizeof(SETUP_DATA);
Status = ReadOnlyVariable->GetVariable(ReadOnlyVariable, L"Setup", &SetupGuid, NULL, &VariableSize, &SetupData);
if (EFI_ERROR(Status))
return Status;
通过ReadOnlyVariable->GetVariable方法来获取setup的所有值。
创建一个hob
HOMEWORK_HOB *homeworkhob = NULL;
EFI_GUID homeworkHobGuid = HOMEWORK_HOB_GUID;
Status = (*PeiServices)->CreateHob (
PeiServices,
EFI_HOB_TYPE_GUID_EXTENSION,
sizeof(HOMEWORK_HOB),
&homeworkhob);
if (EFI_ERROR(Status))
return Status;
仔细看这些code你会发现用到了h文件中定义的GUID与结构体,当然这边只是做了一个简单的数据类型,其实你可以做得更加多的东西。
讲取到的值放入hob中
homeworkhob->EfiHobGuidType.Name=homeworkHobGuid;
homeworkhob->homeworkdata=SetupData.HomeWorkoption;
这里的HomeWorkoption就是我们上一文所加的新选项
HOB在Dxe阶段
新建inf文件
同样的道理需要新建inf文件,加入相关的依赖项
[Defines]
INF_VERSION = 0x00010015
BASE_NAME = HomeWorkDxe
FILE_GUID = 43a12ef5-0372-4119-9f0f-000a8c104c62
MODULE_TYPE = DXE_DRIVER
VERSION_STRING = 1.0
ENTRY_POINT = HomeWorkDxeEntryPoint
新建dxe的 c文件
EFI_GUID GuidHob = HOB_LIST_GUID;
EFI_STATUS Status;
HOMEWORK_HOB *Homeworkhob=NULL;
EFI_GUID HomeworkHobGuid=HOMEWORK_HOB_GUID;
VOID *pHobList = NULL;
pHobList = GetEfiConfigurationTable(SystemTable, &GuidHob);
if (!pHobList) return EFI_NOT_READY;
Homeworkhob = (HOMEWORK_HOB*)pHobList;
while (!EFI_ERROR(Status = FindNextHobByType(EFI_HOB_TYPE_GUID_EXTENSION, &Homeworkhob)))
if (guidcmp(&(*Homeworkhob).EfiHobGuidType.Name, &HomeworkHobGuid) == 0)
break;
if (EFI_ERROR(Status))
return EFI_NOT_FOUND;
else
OEM_TRACE("data=%d\\n",Homeworkhob->homeworkdata);
在dxe阶段,你需要通过GetEfiConfigurationTable拿到hob list的hander,也相当与一个链表的头指针,然后通过FindNextHobByType去遍历这个链表,通过比较GUID进行锁定,并把值写出来。
在这里我提醒一下,所谓的OEM_TRACE是我们自主写的一个module用于串口debug的。如果有可能,我会在纯净的UEFI中再做这个module,让大家可以进行自行编译,而不是现在的只能看博客。
以上是关于我的BIOS之行-hob的使用的主要内容,如果未能解决你的问题,请参考以下文章