UEFI开发与调试---ImageHandle和ControllerHandle

##1.ImageHandle

每个uefi module都是一个image,而每个image对应都有一个ImageHandle,其实ImageHandle的类型就是EFI_HANDLE

typedef VOID                      *EFI_HANDLE;

因此实际上每个ImageHandle是一个void*指针,那么也就是说任何结构体都可以传给他,其实通过代码可知在uefi中,传入ImageHandle中的数据结构只会是IHANDLE:

///
/// IHANDLE - contains a list of protocol handles
///
typedef struct {UINTN               Signature;/// All handles list of IHANDLELIST_ENTRY          AllHandles;/// List of PROTOCOL_INTERFACE's for this handleLIST_ENTRY          Protocols;      UINTN               LocateRequest;/// The Handle Database Key value when this handle was last created or modifiedUINT64              Key;
} IHANDLE;

由此可知,每个ImageHandle其实就对应一个IHANDLE结构,这个结构就是用于描述此image的,我们可以在ImageHandle上安装一系列的接口(就是Protocol),比如在DXE和UEFI驱动中,这一系列接口通过Protocols这个成员连接在一起,它还有AllHandles链表,也就是说系统中所有的IHANDLE也都是连接在一起的,这就会在整个UEFI运行过程中组成一个EFI_HANDLE数据库。

因此在某个模块中实现的接口(Protocol),可以通过一系列的函数,先找到ImageHandle,再通过它找到对应的Protocol,然后在其它的地方调用这些Protocol。UEFI中所有的IHANDLE是通过AllHandles连接在一起的,所有的protocol是通过PROTOCOL_ENTRY结构连接在一起的。

关于ImageHandle和Procotol之间的关系可以参考下图:

摘自UEFI原理与编程_戴正华

##2.ControllerHandle

看了一些书,也在网上搜索了一些Controller的概念,总结了一下我的理解。其实ControllerHandle和上文中介绍的ImageHandle本质上并没有区别,两者都是EFI_HANDLE对象,也就是IHANDLE数据结构。Controller控制器更多的含义应该是逻辑意义上的,它代表着当前IHANDLE对象的父对象,这样对我来说可能更好理解一些,子对象的实现是依赖于父对象之上的,这就更像是linux kernel中,bus总线和device设备之间的关系。

比如说我们系统中要实现一个AC97音频驱动,那么可能会有两个UEFI Driver,一个是PCI驱动,一个是AC97音频驱动提供音频操作的函数,那么我们可以认为PCI驱动是AC97音频驱动的Controller控制器,而AC97音频驱动的实现依赖PCI驱动。

Controller在UEFI中的体现就是函数和参数的命名,比如我们常用到的操作:

gBS->ConnectController()
gBS->DisconnectController()

gBS->ConnectController()这个函数就是用来把我们的驱动按照到父对象上,也就是Controller上,而gBS->DisconnectController()是把我们驱动从对应的Controller上断开。实际进一步跟下去,他们的实现是这样的:

 EFI_STATUSEFIAPICoreConnectController (IN  EFI_HANDLE                ControllerHandle,IN  EFI_HANDLE                *DriverImageHandle    OPTIONAL,IN  EFI_DEVICE_PATH_PROTOCOL  *RemainingDevicePath  OPTIONAL,IN  BOOLEAN                   Recursive)
EFI_STATUS
EFIAPI
CoreDisconnectController (IN  EFI_HANDLE  ControllerHandle,IN  EFI_HANDLE  DriverImageHandle  OPTIONAL,IN  EFI_HANDLE  ChildHandle        OPTIONAL)

举例说明这个函数如何使用,我们可以这样使用:

EFI_STATUS
EFIAPI
BdsLibConnectAllEfi (VOID)
{EFI_STATUS  Status;UINTN       HandleCount;EFI_HANDLE  *HandleBuffer;UINTN       Index;Status = gBS->LocateHandleBuffer (AllHandles,NULL,NULL,&HandleCount,&HandleBuffer);if (EFI_ERROR (Status)) {return Status;}for (Index = 0; Index < HandleCount; Index++) {Status = gBS->ConnectController (HandleBuffer[Index], NULL, NULL, TRUE);}if (HandleBuffer != NULL) {FreePool (HandleBuffer);}return EFI_SUCCESS;
}

ControllerHandle和ChildHandle是有依赖的,并且我们知道驱动之前的联系都是通过Procotol来进行了,所以这种依赖也是通过Procotol来进行的。那么我们在Connect和Disconnect的时候其实只需要查找Controller中的Procotol对应的OpenData和attribute私有数据区就可以找到对应的ChildHandle了。
绑定操作的基本原理是利用Driver Binding Protocol,这是UEFI driver中的一个概念了,在ConnectController中,可以不用指定DriverImageHandle和ChildHandle,因为它内部都可以通过Driver Binding Protocol来查找到对应的绑定信息。在开发UEFI driver时,在driver entry加载时都会利用Driver Binding Protocol进行一些操作。
本文图片摘自《UEFI原理与编程》戴正华

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://xiahunao.cn/news/354184.html

如若内容造成侵权/违法违规/事实不符,请联系瞎胡闹网进行投诉反馈,一经查实,立即删除!

相关文章

UEFI的诞生与优势

UEFI的诞生 随着CPU及其他硬件设备的技术革新&#xff0c;CPU和操作系统已支持到64位&#xff0c;而BIOS却还停留在16位&#xff1b;主板上更加丰富多样的扩展设备&#xff0c;也让BIOS愈加无能为力&#xff0c;使得硬件无法完成初始化。现实表明&#xff0c;BIOS已经无法满足…

UEFI shell - 标准应用程序的编译和加载过程

一、标准应用工程编译 首先了解下,应用程序是怎么被编译成.efi文件: UefiMain.c首先被编译成目标文件UefiMain.obj连接器将目标文件UefiMain.obj和其他库连接成UefiMain.dllGenFw工具将UefiMain.dll转换成UefiMain.efi 说明:连接器在生成UefiMain.dll时使用了/dll/entry:_Mo…

UEFI开发,记录第一场胜利——调用一个自己编写的protocol

本文参考BIOS/UEFI基础——Protocol介绍 大四第一个签三方的工作&#xff0c;BIOS的开发&#xff0c;第一次接触这个领域&#xff0c;在实习之前很好奇&#xff0c;也很有兴趣&#xff0c;但是学习BIOS在一开始注定要碰多次碰壁&#xff0c;实习第三周第二天&#xff0c;终于写…

linux系统nohob安装,Linux启动详解1

一、固件运行 本部分主要参考 戴正华 著《UEFI原理与编程》 CPU在加电后会进入16位实模式状态运行&#xff0c;同时CPU的逻辑电路设计为加电瞬间将CS的值设置为 0xF000、IP的值置为0xFFF0&#xff0c;这样CS&#xff1a;IP就指向0xFFFF0这个地址位置。然后开始执行固件 固件的执…

《UEFI原理与编程》读书笔记

《UEFI原理与编程》读书笔记 读书笔记仅摘取对个人有用的部分&#xff0c;详细内容请阅读原著 目前更新至第七章&#xff0c;因个人仅需要引导程序&#xff0c;故其余部分未介绍&#xff0c;详细内容请阅读原著 书及其资料均已放置在本人资源中&#xff0c;如需下载请移步资源模…

UEFI简介

前言 大多数人接触UEFI都是在PC的应用场景上&#xff0c;有在PC上安装过多操作系统的经历的同学&#xff0c;通常会进入UEFI界面设置操作系统引导顺序、CPU虚拟化等设置。UEFI诞生之初也确实是作为BIOS的替代者&#xff0c;主要应用在PC电脑上。随着手机/平板等移动设备的发展&…

10月书讯(上) | 小长假我读这些新书

华章科技提前祝大家国庆快乐 7天小长假&#xff0c;正是读书好时节 又到上新季&#xff0c;读书与休假更配哦 10月书讯&#xff08;上&#xff09;请查收 快来看看哪本书最属你心意 参与文末赠书活动&#xff0c;好书就要抢先读 — 新书速览 — 1、《计算机系统解密&#xff1a…

UEFI启动流程浅析

BIOS启动流程 SEC&#xff08;Security Phase&#xff0c;安全阶段&#xff09;阶段 SEC阶段是平台初始话的第一个阶段&#xff0c;计算机系统加电后首先进入这个阶段。 CPU上电之后&#xff0c;首先会进行硬件初始化&#xff08;hard reset&#xff09; 其次会进行可选的自检…

UEFI规范实现EDKII项目学习笔记绪论[0]

UEFI规范实现EDKII项目学习笔记绪论[0] 2015-07-10 北京海淀区 张俊浩 这段时间在学习UEFI( Unified Extensible Firmware Interface,统一的可扩展固件接口)&#xff0c;熟悉EDKII&#xff08;EFI Developer KitII&#xff0c;EFI开发工具包&#xff09;项目&#xff0c;…

3.UEFI-edk2 增加中文显示

UEFI-edk2源码中默认只有英文和法文的字库&#xff0c;在UI界面上或者shell终端打印中文字符串&#xff0c;则无法显示。例如&#xff0c;上一篇博客中的TestoneApp.cpp中&#xff0c;增加一行带中文字符串的打印&#xff1a; Print(L"Hello, world!\r\n");Print(L&…

UEFI原理与编程(一)

第一章 UEFI概述(Unified Extensible Firmware Interface 统一的可扩展固件接口) 常见缩写及描述&#xff1a; 缩略词全名描述UEFIUnified Extensible Firmware Interface统一的可扩展固件接口BSBoot Services启动服务RTRuntime Service运行时服务BIOSBasic Input Output Sys…

UEFI学习——事件函数WaitForEvent和CreateEvent/CreateEventEx

本文参考戴正华《UEFI原理与编程》 1.等待事件的服务WaitForEvent 启动服务中的WaitForEvent服务的函数原型&#xff1a; /**等待Event数组内任一事件被触发retval EFI_SUCCESS 下表为*index的事件被触发retval EFI_UNSUPPORTED 当前的TPL不是TPL_AP…

开宗明义—UEFI介绍 (二)

UEFI介绍 声明 上一篇介绍了UEFI的发展历史&#xff0c;以及对UEFI在ARM嵌入式领域的生态状况做了简单的调研。本篇旨在对UEFI规范和PI规范的内容以及二者之间的关系做一个简单的梳理。 本篇参考内容主要来源于以下3方面&#xff1a; (1) 微信公众号“ Wolf UEFI社区 ”系列文章…

UEFI学习——使用gRT->GetVariable读取Setup选项值

先列出代码&#xff0c;程序的解释在后面。 代码&#xff1a; #include <Uefi.h> #include <Library/UefiBootServicesTableLib.h> #include <Library/UefiRuntimeServicesTableLib.h> #include <Library/DebugLib.h> #include <Universal\DriverS…

2.1 对称量量化和非对称量化

前言 int8的数据范围可以表示为-128到127之间的整数 uint8的数据范围可以表示为0到255之间的整数 注释&#xff1a;int8就是用8个比特位来保存整数&#xff0c;第一位用来表示符号。uint8表示无符号整数&#xff0c;没有符号位&#xff0c;8个比特位全部用来表示整数。 1.问题…

Zinx框架学习 - 连接管理

Zinx - V0.9 连接管理 每个服务器的能够处理的最大IO数量是有限的&#xff0c;根据当前服务器能开辟的IO数量决定&#xff0c;最终决定权是内存大小现在我们要为Zinx框架增加链接个数的限定&#xff0c;如果超过⼀定量的客户端个数&#xff0c;Zinx为了保证后端的及时响应&…

澳网:公茂鑫/张择创历史 中国男网夺大满贯首胜

资料图&#xff1a;张择在比赛中。 中新网1月16日电 16日&#xff0c;2019年澳大利亚网球公开赛男双第一轮展开争夺&#xff0c;中国组合张择/公茂鑫苦战3盘战胜马特沃斯基/克里赞&#xff0c;收获中国男网在大满贯正赛的首场胜利&#xff0c;创造历史。 首盘比赛&#xff0c…

吴易昺,创造历史

中国网坛历史性一刻图片 当地时间2月12日 在ATP250达拉斯男单决赛中 中国球员吴易昺&#xff08;bǐng&#xff09;延续出色状态 顶住对手44记ACE的猛烈冲击&#xff0c;化解四个赛点后&#xff0c;以6-7(4)、7-6(3)、7-6(12)击败伊斯内尔&#xff0c;夺得个人以及中国大陆男网…

百合网“免费”革命 一场饮鸩止渴的大戏

在线婚恋市场一直以来都是有风乍起&#xff0c;吹乱一池春水的同时&#xff0c;也往往会带来自身的迷茫。 刚宣布融了15亿资的百合网计划下一步登陆A股&#xff0c; 于是推出了免费沟通的杀手锏&#xff0c;更是号称要彻底颠覆婚恋行业——果然是腰包鼓了&#xff0c;说话都财大…

澳网见证三巨头书写伟大时代 中国军团多点开花

中新网客户端北京1月28日电(记者 岳川) 随着排名世界第一的德约科维奇在男单决赛中直落三盘击败老对手纳达尔&#xff0c;2019年度澳大利亚网球公开赛大幕落下。这是一届注定会在未来被时常提起的赛事&#xff0c;罗德-拉沃尔球场见证了女单新霸主的诞生&#xff0c;见证了德约…