UEFI源码学习3.3 - DXE Event实现

已于 2022-05-08 12:32:50 修改
阅读量828 收藏 4
点赞数
分类专栏： UEFI 文章标签： UEFI
于 2022-05-07 22:37:56 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/u011280717/article/details/124635719
版权

文章目录

edk2/MdeModulePkg/Core/Dxe/Event/Event.c
edk2/MdeModulePkg/Core/Dxe/Event/Tpl.c

1. CoreCreateEvent / CoreCreateEventEx

CoreCreateEvent/CoreCreateEventEx用于创建一个Event，CoreCreateEvent实际上是一个wrapper函数，它内部调用了CoreCreateEventEx，只是EventGroup参数为NULL。

CoreCreateEvent (
  IN UINT32            Type,						--> Event类型
  IN EFI_TPL           NotifyTpl,					--> 通知优先级
  IN EFI_EVENT_NOTIFY  NotifyFunction  OPTIONAL,	--> Event的回调函数
  IN VOID              *NotifyContext  OPTIONAL,	--> 通知上下文
  OUT EFI_EVENT        *Event						--> Event指针
  )
{
  return CoreCreateEventEx (Type, NotifyTpl, NotifyFunction, NotifyContext, NULL, Event);
}

CoreCreateEventEx这个函数也是一个wrapper函数，仅仅在外层检查了参数合法性后调用CoreCreateEventInternal。

CoreCreateEventEx (
  IN UINT32            Type,
  IN EFI_TPL           NotifyTpl,
  IN EFI_EVENT_NOTIFY  NotifyFunction  OPTIONAL,
  IN CONST VOID        *NotifyContext  OPTIONAL,
  IN CONST EFI_GUID    *EventGroup     OPTIONAL,
  OUT EFI_EVENT        *Event
  )
{

  if ((Type & (EVT_NOTIFY_WAIT | EVT_NOTIFY_SIGNAL)) != 0) {
    if ((NotifyTpl != TPL_APPLICATION) &&
        (NotifyTpl != TPL_CALLBACK) &&
        (NotifyTpl != TPL_NOTIFY))
    {
      return EFI_INVALID_PARAMETER;
    }
  }

  return CoreCreateEventInternal (Type, NotifyTpl, NotifyFunction, NotifyContext, EventGroup, Event);
}

CoreCreateEventInternal里面简单来说就为Event创建一个IEVENT对象，并根据参数将IEVENT的成员一个一个填好。如果EVENT的类型是EVT_NOTIFY_SIGNAL, 则要将该EVENT插入到gEventSignalQueue。

CoreCreateEventInternal (
  ...
  )
{
  EFI_STATUS  Status;
  IEVENT      *IEvent;
  INTN        Index;
  
  ...
  if (EventGroup != NULL) {
    //如果带有EventGroup参数，Event类型必须不能为EVT_SIGNAL_EXIT_BOOT_SERVICES和EVT_SIGNAL_VIRTUAL_ADDRESS_CHANGE
    if ((Type == EVT_SIGNAL_EXIT_BOOT_SERVICES) || (Type == EVT_SIGNAL_VIRTUAL_ADDRESS_CHANGE)) {
      return EFI_INVALID_PARAMETER;
    }
	//根据GUID设置Event类型
    if (CompareGuid (EventGroup, &gEfiEventExitBootServicesGuid)) {
      Type = EVT_SIGNAL_EXIT_BOOT_SERVICES;
    } else if (CompareGuid (EventGroup, &gEfiEventVirtualAddressChangeGuid)) {
      Type = EVT_SIGNAL_VIRTUAL_ADDRESS_CHANGE;
    }
  } else {
    //如果没有EvenetGroup参数，Event类型是EVT_SIGNAL_EXIT_BOOT_SERVICES和EVT_SIGNAL_VIRTUAL_ADDRESS_CHANGE的话，设置相应EventGroup类型
    if (Type == EVT_SIGNAL_EXIT_BOOT_SERVICES) {
      EventGroup = &gEfiEventExitBootServicesGuid;
    } else if (Type == EVT_SIGNAL_VIRTUAL_ADDRESS_CHANGE) {
      EventGroup = &gEfiEventVirtualAddressChangeGuid;
    }
  }

  
  if ((Type & (EVT_NOTIFY_WAIT | EVT_NOTIFY_SIGNAL)) != 0) {
    //如果是EVT_NOTIFY_WAIT 或者EVT_NOTIFY_SIGNAL的Event，
    //NotifyFunction必须要有，NotifyTpl 优先级必须在TPL_APPLICATION和TPL_HIGH_LEVEL之间
    if ((NotifyFunction == NULL) ||
        (NotifyTpl <= TPL_APPLICATION) ||
        (NotifyTpl >= TPL_HIGH_LEVEL))
    {
      return EFI_INVALID_PARAMETER;
    }
  } else {
    //其他的类型的Event则不需要通知相关的参数
    NotifyTpl      = 0;
    NotifyFunction = NULL;
    NotifyContext  = NULL;
  }

  //为Event分配一个IEVENT对象。
  if ((Type & EVT_RUNTIME) != 0) {
    IEvent = AllocateRuntimeZeroPool (sizeof (IEVENT));
  } else {
    IEvent = AllocateZeroPool (sizeof (IEVENT));
  }

  //根据参数配置IEVENT的成员
  IEvent->Signature = EVENT_SIGNATURE;
  IEvent->Type      = Type;

  IEvent->NotifyTpl      = NotifyTpl;
  IEvent->NotifyFunction = NotifyFunction;
  IEvent->NotifyContext  = (VOID *)NotifyContext;
  if (EventGroup != NULL) {
    CopyGuid (&IEvent->EventGroup, EventGroup);
    IEvent->ExFlag |= EVT_EXFLAG_EVENT_GROUP;
  }
  //将分配的IEVENT指针返回给调用者。
  *Event = IEvent;

  if ((Type & EVT_RUNTIME) != 0) {
	//如果是EVT_RUNTIME类型的EVENT,则需要填入RuntimeData相关的成员
    IEvent->RuntimeData.Type           = Type;
    IEvent->RuntimeData.NotifyTpl      = NotifyTpl;
    IEvent->RuntimeData.NotifyFunction = NotifyFunction;
    IEvent->RuntimeData.NotifyContext  = (VOID *)NotifyContext;
    IEvent->RuntimeData.Event = (EFI_EVENT *)IEvent;
    //把Event插入gRuntime->EventHea链表
    InsertTailList (&gRuntime->EventHead, &IEvent->RuntimeData.Link);
  }

  CoreAcquireEventLock ();

  if ((Type & EVT_NOTIFY_SIGNAL) != 0x00000000) {
    //如果是EVT_NOTIFY_SIGNAL类型的EVENT,将EVENT插入gEventSignalQueue链表。
    InsertHeadList (&gEventSignalQueue, &IEvent->SignalLink);
  }
  ...
}

2. CoreSignalEvent

CoreSignalEvent会向EVENT发送一个信号，然后在这个函数中回去调用在CreateEvent中注册的回调函数NotifyFunction。
虽然字面意思很简单，但实际上这个简单的操作在这个函数里也饶了一圈。

  1. 它首先会调用CoreNotifySignalList 或者CoreNotifyEvent 把EVENT插入到gEventQueue[Type]链表中
  2. 然后在CoreReleaseEventLock 的调用中从gEventQueue[Type]拿到pending的EVNET，然后去调用EVNET对应的NotifyFunction
EFI_STATUS
EFIAPI
CoreSignalEvent (
  IN EFI_EVENT  UserEvent
  )
{
  IEVENT  *Event;

  Event = UserEvent;

  if (Event == NULL) {
    return EFI_INVALID_PARAMETER;
  }

  if (Event->Signature != EVENT_SIGNATURE) {
    return EFI_INVALID_PARAMETER;
  }

  CoreAcquireEventLock ();

  //
  // If the event is not already signalled, do so
  //

  if (Event->SignalCount == 0x00000000) {
    Event->SignalCount++;

    //
    // If signalling type is a notify function, queue it
    //
    if ((Event->Type & EVT_NOTIFY_SIGNAL) != 0) {
      if ((Event->ExFlag & EVT_EXFLAG_EVENT_GROUP) != 0) {
        //
        // The CreateEventEx() style requires all members of the Event Group
        //  to be signaled.
        //
        CoreReleaseEventLock ();
        CoreNotifySignalList (&Event->EventGroup);
        CoreAcquireEventLock ();
      } else {
        CoreNotifyEvent (Event);
      }
    }
  }

  CoreReleaseEventLock ();
  return EFI_SUCCESS;
}

VOID
CoreNotifyEvent (
  IN  IEVENT  *Event
  )
{

  ...
  //如果Event已经插入了在gEventQueue[Event->NotifyTpl]中，那么就把它从链表中删除
  if (Event->NotifyLink.ForwardLink != NULL) {
    RemoveEntryList (&Event->NotifyLink);
    Event->NotifyLink.ForwardLink = NULL;
  }
  //把这个EVENT插入相应优先级的gEventQueue。
  InsertTailList (&gEventQueue[Event->NotifyTpl], &Event->NotifyLink);
  //将gEventPending 设置上，这在后面的函数中需要使用
  gEventPending |= (UINTN)(1 << Event->NotifyTpl);
}

CoreReleaseEventLock这个函数在释放gEventQueueLock的同时还会去查看gEventQueue中有没有pending的EVENT,如果有，就调用它们的注册的回调函数。CoreReleaseEventLock的函数调用栈如下，最终会调用到CoreDispatchEventNotifies这个函数中把Event的回调函数调用以下

   CoreReleaseEventLock
-->CoreReleaseLock
-->CoreRestoreTpl
-->CoreDispatchEventNotifies

这个函数用于恢复当前任务的Event通知优先级，同时如果有pending的EVENT存在，则调用CoreDispatchEventNotifies处理EVENT。

CoreRestoreTpl (
  IN EFI_TPL  NewTpl
  )
{
  EFI_TPL  OldTpl;
  EFI_TPL  PendingTpl;

  OldTpl = gEfiCurrentTpl;

  //如果有pengding的event存在，调用CoreDispatchEventNotifies 
  while (gEventPending != 0) {	
    ...
    CoreDispatchEventNotifies (gEfiCurrentTpl);
  }

  //当当前任务恢复通知有优先级到NewIpl
  gEfiCurrentTpl = NewTpl;
  ...
}

CoreDispatchEventNotifies 这里就是最终从gEventQueue拿出IEVENT，然后调用回调函数Event->NotifyFunction (Event, Event->NotifyContext);

VOID
CoreDispatchEventNotifies (
  IN EFI_TPL  Priority
  )
{
  IEVENT      *Event;
  LIST_ENTRY  *Head;
  
  CoreAcquireEventLock ();
  //拿到对应通知优先级的gEventQueue
  Head = &gEventQueue[Priority];

  //遍历gEventQueueP链表
  while (!IsListEmpty (Head)) {
    //拿到IEVENT对象
    Event = CR (Head->ForwardLink, IEVENT, NotifyLink, EVENT_SIGNATURE);
    //把它从gEventQueue中删掉
    RemoveEntryList (&Event->NotifyLink);

    Event->NotifyLink.ForwardLink = NULL;
    //把SignalCount清0.
    if ((Event->Type & EVT_NOTIFY_SIGNAL) != 0) {
      Event->SignalCount = 0;
    }
	//这里有递归调用解锁
    CoreReleaseEventLock ();

    //**Signal调用回调函数NotifyFunction**
    Event->NotifyFunction (Event, Event->NotifyContext);

    
    CoreAcquireEventLock ();
  }

  gEventPending &= ~(UINTN)(1 << Priority);
  //这里有递归调用解锁
  CoreReleaseEventLock ();
}

3.CoreWaitForEvent / CoreCheckEvent

CoreWaitForEvent 里面调用了CoreCheckEvent。所以先看CoreCheckEvent。
在CoreCheckEvent中，主要根据Event状态做两种处理。

  • Event->SignalCount = 0的情况下调用CoreNotifyEvent 通知Event，并报告给调用者这个Event还没有Ready。
  • Event->SignalCount ！= 0的情况下，就把Event->SignalCount 清0，并报告给调用者这个Event已经被Singal过了。
CoreCheckEvent (
  IN EFI_EVENT  UserEvent
  )
{
  IEVENT      *Event;
  EFI_STATUS  Status;

  Event = UserEvent;

  ...
  Status = EFI_NOT_READY;
  
  if ((Event->SignalCount == 0) && ((Event->Type & EVT_NOTIFY_WAIT) != 0)) {
	//调用CoreNotifyEvent 通知Event
    CoreAcquireEventLock ();
    if (Event->SignalCount == 0) {
      CoreNotifyEvent (Event);
    }
    CoreReleaseEventLock ();
  }

  if (Event->SignalCount != 0) {
  	//把Event->SignalCount 清0，并报告给调用者这个Event已经被Singal过了
    CoreAcquireEventLock ();

    if (Event->SignalCount != 0) {
      Event->SignalCount = 0;
      Status             = EFI_SUCCESS;
    }
    CoreReleaseEventLock ();
  }

  return Status;
}

CoreWaitForEvent 这个函数调用了CoreCheckEvent， 根据CoreCheckEvent的返回值做一些操作。

  • 如果CoreCheckEvent返回了EFI_NOT_READY，从上面的分析可以得到就是返回了EFI_SUCCESS，那么就会返回给调用者某个Event已经OK了，可以去处理这个Event了。
  • 如果CoreCheckEvent返回了EFI_NOT_READY，那么就会调用CoreSignalEvent (gIdleLoopEvent);发送IDLE的Event，让CPU进入IDLE模式。gIdleLoopEvent这个Event实现在CpuDXE中，在CpuDXE中，IDLE模式的操作其实就是让CPU进入WFI，等待中断到来并等待其他驱动Singal需要的Event，这样就达到了阻塞Wait的效果。
CoreWaitForEvent (
  IN UINTN      NumberOfEvents,
  IN EFI_EVENT  *UserEvents,
  OUT UINTN     *UserIndex
  )
{
  EFI_STATUS  Status;
  UINTN       Index;

  //只能在TPL_APPLICATION的优先级下才能调用CoreWaitForEvent。
  if (gEfiCurrentTpl != TPL_APPLICATION) {
    return EFI_UNSUPPORTED;
  }

  for ( ; ;) {
    //查询所有等待的中断，这里参数是一个数组，所以要遍历这个Evnet数组
    for (Index = 0; Index < NumberOfEvents; Index++) {
      //检查这个Event的状态
      Status = CoreCheckEvent (UserEvents[Index]);

	  //如果是READY，那么就返回。
      if (Status != EFI_NOT_READY) {
        if (UserIndex != NULL) {
          *UserIndex = Index;
        }
        return Status;
      }
    }

    //如果是EFI_NOT_READY，那么就阻塞等待。
    CoreSignalEvent (gIdleLoopEvent);
  }
}
MyeDy
关注
  • 0
    点赞
  • 踩
  • 4
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
UEFI入门之EDK II开发环境搭建
u010614988的专栏
01-30 4089
EDK II是开源的对UEFI标准的实现，目前主流的IBV(BIOS代码供应商，像AMI、Insyde和Byosoft等)的代码都是基于EDK II做二次开发。本文将介绍在Windows10系统中使用VS2017做工具链，基于tag:edk2-stable201911版本代码搭建UEFI开发环境并能运行BIOS模拟器。 准备工作 1. 下载edk II代码。从github中的ed...
UEFi-Specification-2-10
10-22
《UEFI规范2.10：添加龙架构平台》 UEFI（Unified Extensible Firmware Interface）规范2.10版是UEFI论坛发布的一份重要文档，旨在为计算机硬件和操作系统之间的固件接口设定标准。这份规范的更新着重于添加对...
UEFI源码（AMI）CODE_1
01-05
某主板公司泄露的替代BIOS的UEFI源码
【UEFI基础】EDK框架
jiangwei0512的博客
06-05 1万+
【UEFI基础】EDK框架。
推荐开源项目：UEFI-Bootkit
gitblog_00071的博客
05-23 370
推荐开源项目：UEFI-Bootkit 项目地址:https://gitcode.com/ajkhoury/UEFI-Bootkit 1、项目介绍 UEFI-Bootkit 是一个独特的引导加载程序工具，其特别之处在于它完全不使用汇编语言。这个项目由Aidan Khoury和Quarkslab合作开发，灵感来源于dreamboot和VisualUEFI。它是一个小巧的引导工具，旨在提供更简洁、高效...
如何获取UEFI开源资源？
GagaQi的博客
08-15 794
1、认识TianoCore 2004 年 6 月，英特尔宣布将在开源许可下发布其可扩展固件接口 (EFI) 的“基础代码”，这是 16 位 x86“传统”PC BIOS 的继承者。该基础代码由英特尔作为名为 Tiano 的项目代码的一部分开发，是英特尔对 EFI 的“首选实现”。这演变成 EDK、EDK II 和 TianoCore 社区下的其他开源项目。 该社区支持统一可扩展固件接口 (UEFI) 的开源实现。EDK II是一个现代的、功能丰富的、跨平台的固件开发环...
探索创新技术：ReBarUEFI - 一个强大的UEFI固件开发框架
gitblog_00045的博客
04-15 664
探索创新技术：ReBarUEFI - 一个强大的UEFI固件开发框架 项目地址:https://gitcode.com/xCuri0/ReBarUEFI 在计算机科学领域，UEFI（统一可扩展固件接口）是BIOS的现代替代品，为操作系统启动提供了一个更安全、更高效的标准环境。而ReBarUEFI是一个专为UEFI固件开发打造的开源框架，它旨在简化开发者的工作流程，提高开发效率，并且提供了一种灵活...
UEFI-PI-Spec-1-8-March3
最新发布
06-16
UEFI_PI_Spec_1_8_March3
《UEFI内核导读》-样章20210318.pdf
03-18
虽然UEFI框架大大加快了开发效率，但是由于系统固件开发属于比较偏门和专业的领域，学习和入门门槛比较高，现有的BIOS工程师又分布在大大小小的各个公司内部缺乏有效沟通和交流，同时BIOS源码又属于敏感和机密数据受...
UEFI中DXE阶段介绍
02-15
它通过设计以下几个特性来实现可移植性：DXE Foundation的初始状态只依赖于HOB List，这意味着DXE Foundation不依赖于前一个阶段的任何服务，一旦HOB列表被传递给DXE Foundation，就可以卸载前一个阶段的所有服务。...
《UEFI内核导读》-样章20211105.pdf
11-05
《UEFI内核导读》-样章2021/11/05更新 第23篇Secure Boot简介 133 第24篇Open source UEFI BIOS开发实战简介 139 第25篇 How to rotate Screen 143 第26篇Platform Environment Control Interface简介 146
UEFI开发编程汇总 (持续更新)
楼中望月
06-16 2130
UEFI开发编译、技巧集合
UEFI 基础教程 （一） - 基于QEMU搭建UEFI开发环境(win/linux)
xiaopangzi313的专栏
04-26 2万+
UEFI 基础教程 （一）— 搭建UEFI开发环境 下载UEFI开源代码 cmd进入C盘根目录，git clone https://github.com/tianocore/edk2.git edkii 安装ASL编译器 下载 iasl-win-20190405.zip，然后解压至C:\asl。 安装NASM编译器 下载 nasm-2.14.02-win64.zip，解压nasm-2.1......
【UEFI实战】Intel开源固件项目
jiangwei0512的博客
11-26 4735
【UEFI实战】Intel开源固件项目。
UEFI原理与编程实践--UEFI系统的启动过程
Anthony的博客
11-24 3408
安全验证阶段，这个阶段，需要用Assembly做一些 C 无法处理的工作，C语言无法处理CPU的特殊寄存器。让CPU进入Protected Mode(Flat Mode)的环境，会使用到CPU内部的临时ram，其实也就是缓存，这个阶段主要还是使用的汇编，也就是说为后面的阶段建立一个C语言和硬件通信的编译环境，最后将控制权交给PEI Phase。
【UEFI基础】UEFI Shell
热门推荐
jiangwei0512的博客
03-29 2万+
【UEFI基础】UEFI Shell。
UEFI中的PCI设备扫描及分配Mem/Io空间过程
太初有道
07-03 1万+
最近在调试解决PCI设备相关的问题，然后对UEFI下面的这部分实现有了初步的了解，为了防止后面慢慢的又忘记了，所以还是决定将最近的收获都记录起来，各位读者如果发现哪里记录或者总结的不对，欢迎留言指正。 PciHostBridgeDxe 这个驱动是为pci bus驱动执行做前期准备的驱动，在这个驱动里面主要是建立相应的软件结构来描述Host主桥，以及注册一些protocol是为pci bus 驱动使...
UEFI源码学习3.7 - NorFlashDxe
u011280717的博客
05-30 1147
文章目录1. 数据结构2. 初始化3. 读写实现4. 测试代码 1. 数据结构 2. 初始化 3. 读写实现 4. 测试代码
UEFI源码解析之EVENT
wangadi057612的博客
02-05 2342
UEFI-EDK2是单核单线程的架构，除了时钟中断外，没有其他中断机制，Event在UEFI中实现了异步执行的能力；
UEFI_APPLICATION调用DXE_SMM_DRIVER
01-03
UEFI_APPLICATION无法直接调用DXE_SMM_DRIVER。UEFI_APPLICATION是一种UEFI应用程序类型，而DXE_SMM_DRIVER是一种DXE驱动类型。UEFI应用程序和DXE驱动之间的通信是通过UEFI服务和协议进行的。UEFI应用程序可以使用...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值