【UEFI实战】HII之涉及模块

已于 2022-02-08 14:55:59 修改
阅读量3.1k 收藏 5
点赞数 1
分类专栏： UEFI开发基础 文章标签： hii setup uefi
于 2022-02-08 14:55:20 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/jiangwei0512/article/details/122824065
版权

模块

HII的交互逻辑如下图所示：

在这里插入图片描述

其中上边是输入设备，比如键盘、鼠标等；右边是输出设备，比如显示器；左边是UEFI变量，用来存放HII会涉及到的数据。这三个部分都属于UEFI基础，不是这里介绍的对象，这里主要说明中间紫色部分的IFR Browser和HII Database，它们也是HII需要关注的重要模块，对应到代码中主要有如下的几个模块：

MdeModulePkg/Universal/HiiDatabaseDxe/HiiDatabaseDxe.inf
MdeModulePkg/Universal/SetupBrowserDxe/SetupBrowserDxe.inf
MdeModulePkg/Universal/DisplayEngineDxe/DisplayEngineDxe.inf

除此之外，其它的模块（就是上图绿色部分Driver）也会提供用户交互界面需要的元素，这通常是为了完成该模块需要的操作。

在上面的三个模块中，HiiDatabaseDxe.inf模块用来初始化并安装操作界面元素的Protocol以及配置相关的Protocol，这些界面元素包括字体，字符串，结构、图像等。SetupBrowserDxe.inf这个模块依赖于HiiDatabaseDxe.inf，它提供了上图中间部分的实现，实际上是整个用户交互界面的引擎，用来实现各类必要的操作（实际上也不是它来实现，它只是调用了在绿色部分Driver中的操作）。DisplayEngineDxe.inf是配合SetupBrowserDxe.inf一起使用的，它依赖于后者。

模块安装的Protocol有如下一些：

在这里插入图片描述

HiiDatabaseDxe.inf

本模块初始化了HII_DATABASE_PRIVATE_DATA（对应变量mPrivate）：

  InitializeListHead (&mPrivate.DatabaseList);
  InitializeListHead (&mPrivate.DatabaseNotifyList);
  InitializeListHead (&mPrivate.HiiHandleList);
  InitializeListHead (&mPrivate.FontInfoList);

然后安装了一堆Protocol：

  Status = gBS->InstallMultipleProtocolInterfaces (
                  &Handle,
                  &gEfiHiiFontProtocolGuid,
                  &mPrivate.HiiFont,
                  &gEfiHiiStringProtocolGuid,
                  &mPrivate.HiiString,
                  &gEfiHiiDatabaseProtocolGuid,
                  &mPrivate.HiiDatabase,
                  &gEfiHiiConfigRoutingProtocolGuid,
                  &mPrivate.ConfigRouting,
                  &gEfiConfigKeywordHandlerProtocolGuid,
                  &mPrivate.ConfigKeywordHandler,
                  NULL
                  );

还有一部分是可选的：

  if (FeaturePcdGet (PcdSupportHiiImageProtocol)) {
    Status = gBS->InstallMultipleProtocolInterfaces (
                    &Handle,
                    &gEfiHiiImageProtocolGuid, &mPrivate.HiiImage,
                    &gEfiHiiImageExProtocolGuid, &mPrivate.HiiImageEx,
                    NULL
                    );

  }

关于各个安装的Protocol，后续会介绍。这些Protocol都安装到了前面提到的HII_DATABASE_PRIVATE_DATA结构体：

typedef struct _HII_DATABASE_PRIVATE_DATA {
  UINTN                                 Signature;
  LIST_ENTRY                            DatabaseList;
  LIST_ENTRY                            DatabaseNotifyList;
  EFI_HII_FONT_PROTOCOL                 HiiFont;
  EFI_HII_IMAGE_PROTOCOL                HiiImage;
  EFI_HII_IMAGE_EX_PROTOCOL             HiiImageEx;
  EFI_HII_STRING_PROTOCOL               HiiString;
  EFI_HII_DATABASE_PROTOCOL             HiiDatabase;
  EFI_HII_CONFIG_ROUTING_PROTOCOL       ConfigRouting;
  EFI_CONFIG_KEYWORD_HANDLER_PROTOCOL   ConfigKeywordHandler;
  LIST_ENTRY                            HiiHandleList;
  INTN                                  HiiHandleCount;
  LIST_ENTRY                            FontInfoList;  // global font info list
  UINTN                                 Attribute;     // default system color
  EFI_GUID                              CurrentLayoutGuid;
  EFI_HII_KEYBOARD_LAYOUT               *CurrentLayout;
} HII_DATABASE_PRIVATE_DATA;

这些Protocol就是用来操作UEFI交互界面中的字体、字符串、图像等元素的。

SetupBrowserDxe.inf

该模块依赖于在HiiDatabaseDxe.inf中安装的某些Protocol，所以现有LocateProtocol()操作：

  //
  // Locate required Hii relative protocols
  //
  Status = gBS->LocateProtocol (
                  &gEfiHiiDatabaseProtocolGuid,
                  NULL,
                  (VOID **) &mHiiDatabase
                  );
  ASSERT_EFI_ERROR (Status);
 
  Status = gBS->LocateProtocol (
                  &gEfiHiiConfigRoutingProtocolGuid,
                  NULL,
                  (VOID **) &mHiiConfigRouting
                  );
  ASSERT_EFI_ERROR (Status);
 
  Status = gBS->LocateProtocol (
                  &gEfiDevicePathFromTextProtocolGuid,
                  NULL,
                  (VOID **) &mPathFromText
                  );

然后安装Protocol：

  //
  // Install FormBrowser2 protocol
  //
  mPrivateData.Handle = NULL;
  Status = gBS->InstallProtocolInterface (
                  &mPrivateData.Handle,
                  &gEfiFormBrowser2ProtocolGuid,
                  EFI_NATIVE_INTERFACE,
                  &mPrivateData.FormBrowser2
                  );
  ASSERT_EFI_ERROR (Status);
 
  Status = gBS->InstallProtocolInterface (
                  &mPrivateData.Handle,
                  &gEdkiiFormBrowserEx2ProtocolGuid,
                  EFI_NATIVE_INTERFACE,
                  &mPrivateData.FormBrowserEx2
                  );
  ASSERT_EFI_ERROR (Status);
  
  Status = gBS->InstallProtocolInterface (
                  &mPrivateData.Handle,
                  &gEdkiiFormBrowserExProtocolGuid,
                  EFI_NATIVE_INTERFACE,
                  &mPrivateData.FormBrowserEx
                  );
  ASSERT_EFI_ERROR (Status);

然后初始化SETUP_DRIVER_PRIVATE_DATA（对应变量mPrivateData）：

  InitializeListHead (&mPrivateData.FormBrowserEx2.FormViewHistoryHead);
  InitializeListHead (&mPrivateData.FormBrowserEx2.OverrideQestListHead);

还有初始化EDKII_FORM_DISPLAY_ENGINE_PROTOCOL（对应mFormDisplay，这个Protocol实际上会在DisplayEngineDxe.inf整个模块中安装，所以利用了Callback方式）：

  Status = gBS->LocateProtocol (
                  &gEdkiiFormDisplayEngineProtocolGuid,
                  NULL,
                  (VOID **) &mFormDisplay
                  );
 
  if (EFI_ERROR (Status)) {
    EfiCreateProtocolNotifyEvent (
      &gEdkiiFormDisplayEngineProtocolGuid,
      TPL_CALLBACK,
      FormDisplayCallback,
      NULL,
      &Registration
      );
  }

以及FORM_DISPLAY_ENGINE_FORM（对应gDisplayFormData）：

/**
  Initialize the Display form structure data.
**/
VOID
InitializeDisplayFormData (
  VOID
  )
{
  EFI_STATUS  Status;
 
  gDisplayFormData.Signature   = FORM_DISPLAY_ENGINE_FORM_SIGNATURE;
  gDisplayFormData.Version     = FORM_DISPLAY_ENGINE_VERSION_1;
  gDisplayFormData.ImageId     = 0;
  gDisplayFormData.AnimationId = 0;
 
  InitializeListHead (&gDisplayFormData.StatementListHead);
  InitializeListHead (&gDisplayFormData.StatementListOSF);
  InitializeListHead (&gDisplayFormData.HotKeyListHead);
 
  Status = gBS->CreateEvent (
        EVT_NOTIFY_WAIT, 
        TPL_CALLBACK,
        EfiEventEmptyFunction,
        NULL,
        &mValueChangedEvent
        );
  ASSERT_EFI_ERROR (Status); 
}

DisplayEngineDxe.inf

首先是安装一个Strings：

  gHiiHandle = HiiAddPackages (
                 &gDisplayEngineGuid,
                 ImageHandle,
                 DisplayEngineStrings,
                 NULL
                 );
  ASSERT (gHiiHandle != NULL);

然后是安装Protocol：

  //
  // Install Form Display protocol
  //
  Status = gBS->InstallProtocolInterface (
                  &mPrivateData.Handle,
                  &gEdkiiFormDisplayEngineProtocolGuid,
                  EFI_NATIVE_INTERFACE,
                  &mPrivateData.FromDisplayProt
                  );
  ASSERT_EFI_ERROR (Status);

之后初始化一堆字符串：

InitializeDisplayStrings();
 
/**
  Initialize the HII String Token to the correct values.
**/
VOID
InitializeDisplayStrings (
  VOID
  )
{
  gReconnectConfirmChanges = GetToken (STRING_TOKEN (RECONNECT_CONFIRM_CHANGES), gHiiHandle);
  mUnknownString        = GetToken (STRING_TOKEN (UNKNOWN_STRING), gHiiHandle);
  gSaveFailed           = GetToken (STRING_TOKEN (SAVE_FAILED), gHiiHandle);
  gNoSubmitIfFailed     = GetToken (STRING_TOKEN (NO_SUBMIT_IF_CHECK_FAILED), gHiiHandle);
  gReconnectFail        = GetToken (STRING_TOKEN (RECONNECT_FAILED), gHiiHandle);
  gReconnectRequired    = GetToken (STRING_TOKEN (RECONNECT_REQUIRED), gHiiHandle);
  gChangesOpt           = GetToken (STRING_TOKEN (RECONNECT_CHANGES_OPTIONS), gHiiHandle);
  gSaveProcess          = GetToken (STRING_TOKEN (DISCARD_OR_JUMP), gHiiHandle);
  gSaveNoSubmitProcess  = GetToken (STRING_TOKEN (DISCARD_OR_CHECK), gHiiHandle);
  gDiscardChange        = GetToken (STRING_TOKEN (DISCARD_OR_JUMP_DISCARD), gHiiHandle);
  gJumpToFormSet        = GetToken (STRING_TOKEN (DISCARD_OR_JUMP_JUMP), gHiiHandle);
  gCheckError           = GetToken (STRING_TOKEN (DISCARD_OR_CHECK_CHECK), gHiiHandle);
  gPromptForData        = GetToken (STRING_TOKEN (PROMPT_FOR_DATA), gHiiHandle);
  gPromptForPassword    = GetToken (STRING_TOKEN (PROMPT_FOR_PASSWORD), gHiiHandle);
  gPromptForNewPassword = GetToken (STRING_TOKEN (PROMPT_FOR_NEW_PASSWORD), gHiiHandle);
  gConfirmPassword      = GetToken (STRING_TOKEN (CONFIRM_PASSWORD), gHiiHandle);
  gConfirmError         = GetToken (STRING_TOKEN (CONFIRM_ERROR), gHiiHandle);
  gPassowordInvalid     = GetToken (STRING_TOKEN (PASSWORD_INVALID), gHiiHandle);
  gPressEnter           = GetToken (STRING_TOKEN (PRESS_ENTER), gHiiHandle);
  gEmptyString          = GetToken (STRING_TOKEN (EMPTY_STRING), gHiiHandle);
  gMiniString           = GetToken (STRING_TOKEN (MINI_STRING), gHiiHandle);
  gOptionMismatch       = GetToken (STRING_TOKEN (OPTION_MISMATCH), gHiiHandle);
  gFormSuppress         = GetToken (STRING_TOKEN (FORM_SUPPRESSED), gHiiHandle);
  gProtocolNotFound     = GetToken (STRING_TOKEN (PROTOCOL_NOT_FOUND), gHiiHandle);
  gFormNotFound         = GetToken (STRING_TOKEN (STATUS_BROWSER_FORM_NOT_FOUND), gHiiHandle);
  gNoSubmitIf           = GetToken (STRING_TOKEN (STATUS_BROWSER_NO_SUBMIT_IF), gHiiHandle);
  gBrowserError         = GetToken (STRING_TOKEN (STATUS_BROWSER_ERROR), gHiiHandle);
  gConfirmDefaultMsg    = GetToken (STRING_TOKEN (CONFIRM_DEFAULT_MESSAGE), gHiiHandle);
  gConfirmDiscardMsg    = GetToken (STRING_TOKEN (CONFIRM_DISCARD_MESSAGE), gHiiHandle);
  gConfirmSubmitMsg     = GetToken (STRING_TOKEN (CONFIRM_SUBMIT_MESSAGE), gHiiHandle);
  gConfirmResetMsg      = GetToken (STRING_TOKEN (CONFIRM_RESET_MESSAGE), gHiiHandle);
  gConfirmExitMsg       = GetToken (STRING_TOKEN (CONFIRM_EXIT_MESSAGE), gHiiHandle);
  gConfirmDefaultMsg2nd = GetToken (STRING_TOKEN (CONFIRM_DEFAULT_MESSAGE_2ND), gHiiHandle);
  gConfirmSubmitMsg2nd  = GetToken (STRING_TOKEN (CONFIRM_SUBMIT_MESSAGE_2ND), gHiiHandle);
  gConfirmResetMsg2nd   = GetToken (STRING_TOKEN (CONFIRM_RESET_MESSAGE_2ND), gHiiHandle);
  gConfirmExitMsg2nd    = GetToken (STRING_TOKEN (CONFIRM_EXIT_MESSAGE_2ND), gHiiHandle);
  gConfirmOpt           = GetToken (STRING_TOKEN (CONFIRM_OPTION), gHiiHandle);
  gConfirmOptYes        = GetToken (STRING_TOKEN (CONFIRM_OPTION_YES), gHiiHandle);
  gConfirmOptNo         = GetToken (STRING_TOKEN (CONFIRM_OPTION_NO), gHiiHandle);
  gConfirmMsgConnect    = GetToken (STRING_TOKEN (CONFIRM_OPTION_CONNECT), gHiiHandle);
  gConfirmMsgEnd        = GetToken (STRING_TOKEN (CONFIRM_OPTION_END), gHiiHandle);
  gPasswordUnsupported  = GetToken (STRING_TOKEN (PASSWORD_NOT_SUPPORTED ), gHiiHandle);
}

之后初始化几个变量：

  ZeroMem (&gHighligthMenuInfo, sizeof (gHighligthMenuInfo));
  ZeroMem (&gOldFormEntry, sizeof (gOldFormEntry));

最后注册几个快捷键：

  //
  // Use BrowserEx2 protocol to register HotKey.
  // 
  Status = gBS->LocateProtocol (&gEdkiiFormBrowserEx2ProtocolGuid, NULL, (VOID **) &FormBrowserEx2);
  if (!EFI_ERROR (Status)) {
    //
    // Register the default HotKey F9 and F10 again.
    //
    HotKey.UnicodeChar = CHAR_NULL;
    HotKey.ScanCode   = SCAN_F10;
    NewString         = HiiGetString (gHiiHandle, STRING_TOKEN (FUNCTION_TEN_STRING), NULL);
    ASSERT (NewString != NULL);
    FormBrowserEx2->RegisterHotKey (&HotKey, BROWSER_ACTION_SUBMIT, 0, NewString);
 
    HotKey.ScanCode   = SCAN_F9;
    NewString         = HiiGetString (gHiiHandle, STRING_TOKEN (FUNCTION_NINE_STRING), NULL);
    ASSERT (NewString != NULL);
    FormBrowserEx2->RegisterHotKey (&HotKey, BROWSER_ACTION_DEFAULT, EFI_HII_DEFAULT_CLASS_STANDARD, NewString);
  }
jiangwei0512
关注
  • 1
    点赞
  • 踩
  • 5
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
UEFI实战 gST、gBS和gImageHandle
qq_30135687的博客
09-05 743
文章目录一、gST、gBS和gImageHandle是什么？二、使用步骤1.变量定义2.变量的初始化3.gST、gBS和gImageHandle的使用 一、gST、gBS和gImageHandle是什么？ gST：globalSystemTable，指向SystemTable，EFI系统表的缓存指针； gBS：globalBootServices，指向SystemTable->BootServices，EFI引导服务表的缓存指针； gImageHandle：ImageHandle，Image句柄的
FirmwareModule:UEFI SLIC进样器固件模块
05-01
小心此模块是实验性的！！！ 准备恢复一块砖砌的主板 构建过程将生成ffs图像。 使用MMtool.exe替换目标固件中的MSOA。 闪存修改后的固件使用InstallData.cmd将Marker，Key，Slp字符串写入NVRAM。 ！！！！为获得...
UEFI HII (Human Interface Infrastructure)一些知识点
weixin_50158428的博客
05-17 635
HII database 涉及到packagelist-》Forms package-》IFR-》Opcode数据结构
【UEFI实战】HII之FrontPage
jiangwei0512的博客
02-08 3280
【UEFI实战】HII之FrontPage。
【UEFI实战】HII之代码示例
jiangwei0512的博客
02-08 6763
【UEFI实战】HII之代码示例。
UEFI Setup界面Hii动态创建选项
最新发布
qq_43561214的博客
02-26 1194
每个界面的选项一些操作 恢复默认值 动态创建的选项需要配置对应的当前值或者BufferStorage的值进行显示和存取操作，CallBack针对选项的操作进行执行CallBacFunc函数,其中实例需要自己实现每个vfr都可以按照需求实现自己的ConfigAccess Protocol。使用form formid 点击goto选项会跳到相同的formid页面。1.Vfr文件中建立Label ，在C文件中动态插入选项到Label位置。实例：这样就实现在vfr中跳转到不同的Form页面。
【UEFI实战】HII之HII数据库和Form浏览器
jiangwei0512的博客
02-08 1771
【UEFI实战】HII之HII数据库和Form浏览器。
UEFI实战--------HII之uni文件
技术联盟
03-11 1670
uni文件HII的实现涉及到多种不同类型的文件，uni文件是其中最简单的一种，它用来存放各种语言的字符串以实现本地化。本节主要参考自《edk-ii-uni-specification.pdf》，后面简称为参考文档。
uefi实战：hii之vfr文件
07-15
在实战中，您可以使用VFR文件来定义UEFI固件中的用户界面。首先，您需要创建一个VFR文件，其中包含界面的布局和控件的定义。然后，使用编译器将VFR文件编译为对应的二进制格式，生成一个可执行的HII包。最后，将HII...
HII_9_2.zip_UEFI Bios_UEFI Spec_human_uefi
09-21
本文将深入探讨UEFI BIOS的人机接口协议（Human Interface Interface，简称HII），以及UEFI规范的相关知识。 UEFI BIOS的人机接口协议是UEFI环境下的用户界面标准，用于在系统启动和管理过程中提供图形化或文本化的...
bios/uefi HII基本框架及概述
07-15
HII（Human Interface Infrastructure）是UEFI中的一个基本框架，它提供了一种标准化的方式来创建和管理图形用户界面（GUI）。下面是对BIOS/UEFI和HII的基本概述： 1. BIOS：BIOS是一种早期的固件接口，在过去的...
UEFI开发探索17 – 使用HII显示汉字2
09-15 1226
(请保留-> 作者: 罗冰) 本篇博客的关键字：SimpleFont。 上次编程后，我始终在思考如何在UEFI Shell下显示汉字。上一篇中，参考书中的例子，基本了解了字符串资源是怎么组织的。当在TestString函数中，把参数Language改为”zh-Hans”，什么也没有显示。 看来还是缺少相应的字库。 UEFI下提供了SimpleFont和Font字体，前一个相对简单些，...
【UEFI实战】HII之uni文件
jiangwei0512的博客
02-08 3966
【UEFI实战】HII之uni文件。
【UEFI实战】UEFI用户交互界面基础说明
热门推荐
jiangwei0512的博客
03-30 1万+
【UEFI实战】UEFI用户交互界面基础说明。
UEFI开发探索18 – 使用HII显示汉字3
09-16 1683
(请保留-> 作者: 罗冰) 本篇博客的关键字：Font。 今天准备把UEFI另外一种字体Font的方方面面研究一下，仍旧是以代码移植为主，间以解决自己提的几个问题。 1 Text模式和Graphics模式 实验之前，我想谈一下Text模式和Graphics模式。UEFI spec中，对于Text模式和Graphics模式谈得比较少。我一直很疑惑，spec中的Text模式和Graph...
UEFI学习1
qq_28629687的博客
09-12 1259
本文主要翻译wikipedia：https://en.wikipedia.org/wiki/Unified_Extensible_Firmware_Interface 统一可扩展固件接口(UEFI)是定义操作系统和平台固件之间的软件接口的规范。UEFI替换了最初出现在所有IBM pc兼容的个人计算机上的基本输入/输出系统(BIOS)固件接口，大多数UEFI固件实现都为BIOS服务提供了遗留支持。...
【BIOS/UEFI】HII 基本框架及概述
weixin_45258382的博客
12-23 5081
HII（Human Interface Infrastructure ）定义了一套管理用户输入的基础框架。HII数据库主要提供用户安装、卸载以及使用各种字符串、字体和图片等资源的接口。驱动程序和应用程序将元素（如字体、字符串、图像和表单）安装到 HII 数据库中，该数据库充当整个平台的中央存储库。Forms Browser 使用这些元素在显示设备上呈现用户界面，并通过 HID 设备从用户接收信息。
UEFI HII驱动开发——HII资源绑定的方法
yao00037的博客
06-19 786
方法一 调用EFI_HII_DATABASE_PROTOCOL提供的NewPackageList()进行绑定 在模块的inf文件中需要定义UEFI_HII_RESOURCE_SECTION = TRUE 该方法不能满足模块中提供多个form的功能 方法二 调用HiiLib中的HiiAddPackages接口进行绑定 inf文件中不需要定义UEFI_HII_RESOURCE_SECTION = TRUE 在源文件中需要声明extern UINT8 ModuleStrings[] 和 extern UIN
【UEFI实战】HII之配置
jiangwei0512的博客
02-08 2979
【UEFI实战】HII之配置。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值