UEFI之VFR

最新推荐文章于 2024-05-17 03:45:10 发布
最新推荐文章于 2024-05-17 03:45:10 发布
阅读量3.8k 收藏 16
点赞数 4
分类专栏： UEFI 文章标签： bios uefi
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/u011057409/article/details/117638304
版权

概述

UEFI用户交互界面的实现涉及到多种不同类型的文件，这里要讲的是VFR(Visual Forms Representation)文件，相比UNI文件它要复杂得多，理解起来也更困难。
UEFI交互界面那些字符串是来自UNI文件的（其实并不是全部来自UNI，也有部分是直接通过代码生成的），而整个窗体的框架部分则是来自VFR文件的。
在UEFI中，构成这样的窗体的组件大致有四种，分别是Strings，Forms，Fonts和Images，如下图所示：
在这里插入图片描述

Strings就是UNI文件提供的，Forms就是本文的VFR文件提供的，本文主要介绍的就是这个Forms，以及构成Forms的VFR文件。

Forms：描述了窗体的组织形式，提供了用户交互的方式和交互内容的存储方式等。
Forms是以二进制的形式提供的，这种二进制在EDK框架中被称为IFR（就是上述定义中提到的Internal Forms Representation）。
而IFR通过编译VFR来生成（关于编译工具，在EDK源代码中也有相应的源码，不过没有研究过不确定怎么用）。
因此，总的来说就是，我们通过编写VFR文件来完成对UEFI交互界面的组织形式和交互方式等相关内容的定义。

语法

VFR文件采用的是BNF语法，与DSC文件采用“#”作为注释标志不同，它使用“//”作为注释标志。另外还有两个关键字是“#define”和“#include”，用来定义和包含头文件的，类似于C的语法。

formset是VFR文件中最重要的部分，用来组成窗体的最常用的结构。其示例如下：
MdeModulePkg/Universal/DriverSampleDxe/Vfr.vfr

formset
guid = {0xcc5ebb4f, 0xf562, 0x11e7, {0x92, 0x11, 0xf4, 0x8c, 0x50, 0x49, 0xe3, 0xa4}},
title = STRING_TOKEN(STR_SAMPLE_FORM_SET_TITLE),
help = STRING_TOKEN(STR_SAMPLE_FORM_SET_HELP),
classguid = EFI_HII_PLATFORM_SETUP_FORMSET_GUID
form formid = 1, title = STRING_TOKEN(STR_SAMPLE_FORM1_TITLE);
…
endform;
endformset;

formset是关键字，用来标志整个窗体的开始，与标志窗体结束的endformset成对出现。其中各关键字的含义为：
guid： 标志本formset的GUID值；
title：在界面中标志本formset的字符串标题；
help：在界面上显示本formset的帮助信息；
classguid: 本formaset所挂载页面的GUID值。

在formaset的集合中，可以用“form”和“endform”定义一个完整的页面，比如这篇博客中给出的示例

form formid = ADVANCED_MANAGER_FORM_ID,
    title  = STRING_TOKEN(STR_EDKII_MENU_TITLE);
    subtitle text = STRING_TOKEN(STR_DEVICES_LIST);

    label LABEL_DEVICES_LIST;
    label LABEL_END;

    subtitle text = STRING_TOKEN(STR_EMPTY_STRING);
    subtitle text = STRING_TOKEN(STR_EMPTY_STRING);
    subtitle text = STRING_TOKEN(STR_EXIT_STRING);
  endform;

FormSet 定义

vfrFormSetDefinition	::=
		"formset"
		"guid"	"="	guidDefinition	","
		"title"	"="	getStringId	","
		"help"	"="	getStringId	","
		{	"classguid"	"="	classguidDefinition	","	}
		{	"class"	"="	classDefinition	","	}
		{	"subclass"	"="	subclassDefinition	","	}
		vfrFormSetList
		"endformset"	";"
classguidDefinition	::=
		guidDefinition	{	"|"	guidDefinition	}	{	"|"	guidDefinition	}
classDefinition	::=
		validClassNames	(	"|"	validClassNames	)*
validClassNames	::=
				"NON_DEVICE"
		|	"DISK_DEVICE"
		|	"VIDEO_DEVICE"
		|	"NETWORK_DEVICE"
		|	"INPUT_DEVICE"
		|	"ONBOARD_DEVICE"
		|	"OTHER_DEVICE"
		|	Number
subclassDefinition	::=
				"SETUP_APPLICATION"
		|	"GENERAL_APPLICATION"
		|	"FRONT_PAGE"
		|	"SINGLE_USE"
		|	Number

例如

FormSet List

formset内部定义了很多的子选项，称为formset list，也就是上一节formset定义中的vfrFormSetList。
前面的例子中用到的form就是其中的一种

formset list可以有如下的内容：

vfrFormSetList	::=
		(
						vfrFormDefinition
				|	vfrFormMapDefinition
				|	vfrStatementImage
				|	vfrStatementVarStoreLinear
				|	vfrStatementVarStoreEfi
				|	vfrStatementVarStoreNameValue
				|	vfrStatementDefaultStore
				|	vfrStatementDisableIfFormSet
				|	vfrStatementSuppressIfFormSet
				|	vfrStatementExtension
				)*

上述的内容可以分为几种不同的类型：

  1. 变量定义，如defaultstore，varstore，efivarstore，namevaluevarstore等；
  2. 控制语句，它会做if判断来确定其包含的formset list是否会被使用，主要有disableif，suppressif，grayoutif和goto语句等（上述的语句只在目前只在form类型语句中见到过，在其外没遇见过，不确定是否可以在它之外）；
  3. form语句，它们是formset里面的主体部分，有form，formmap等；

变量定义

  • Default Stores Definition
    defaultstore：
vfrStatementDefaultStore	::=
		"defaultstore"	StringIdentifier	","
		"prompt"	"="	getStringId
		{	","	"attribute"	"="	Number	}	";"

例：


  defaultstore MyStandardDefault,
    prompt      = STRING_TOKEN(STR_STANDARD_DEFAULT_PROMPT),
    attribute   = 0x0000;                         // Default ID: 0000 standard default

  defaultstore MyManufactureDefault,
    prompt      = STRING_TOKEN(STR_MANUFACTURE_DEFAULT_PROMPT),
    attribute   = 0x0001;                         // Default ID: 0001 manufacture
  • Variable Store Definition
    varstore
vfrStatementVarStoreLinear	::=
		"varstore"
		(
						StringIdentifier	","
				|	"UINT8"	","
				|	"UINT16"	","
				|	"UINT32"	","
				|	"UINT64"	","
				|	"EFI_HII_DATE"	","
				|	"EFI_HII_TIME"	","
				|	"EFI_HII_REF"	","
		)
		{	"varid"	"="	Number	","	}
		"name"	"="	StringIdentifier	","
		"guid"	"="	guidDefinition	";"

第一个StringIdentifier表示的是类型，第二个表示的是变量名，name和guid连起来就可以表示该特定的变量。

例：

 //
  // Define a Buffer Storage (EFI_IFR_VARSTORE)
  //
  varstore DRIVER_SAMPLE_CONFIGURATION,     // This is the data structure type
    varid = CONFIGURATION_VARSTORE_ID,      // Optional VarStore ID
    name  = MyIfrNVData,                    // Define referenced name in vfr
    guid  = IPMI_CONFIG_FORMSET_GUID;     // GUID of this buffer storage

它定义的是一个数据结构体变量，类型就是DRIVER_SAMPLE_CONFIGURATION。
MyIfrNVData是变量的名称，后面的VFR表达式中会通过该名称去引用该变量。
结构体原型在这里：DriverSampleDxe/NVDataStruc.h

  • EFI Variable Store Definition

efivarstore

vfrStatementVarStoreEfi	::=
		"efivarstore"
		(
						StringIdentifier	","
				|	"UINT8"	","
				|	"UINT16"	","
				|	"UINT32"	","
				|	"UINT64"	","
				|	"EFI_HII_DATE"	","
				|	"EFI_HII_TIME"	","
				|	"EFI_HII_REF"	","
		)
		{	"varid"	"="	Number	","	}
		"attribute"	"="	Number	(	"|"	Number	)*	","
		"name"	"="	StringIdentifier	","
		"guid"	"="	guidDefinition	";"

例：

 //
  // Define a EFI variable Storage (EFI_IFR_VARSTORE_EFI)
  //
  efivarstore MY_EFI_VARSTORE_DATA,
    attribute = EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_NON_VOLATILE,  // EFI variable attribures  
    name  = MyEfiVar,
    guid  = IPMI_CONFIG_FORMSET_GUID;

这里定义的就是UEFI变量，还可以声明变量的属性。,MY_EFI_VARSTORE_DATA 是结构体名
结构体原型在这里：DriverSampleDxe/NVDataStruc.h

  • Variable Name Store Definition

namevaluevarstore

vfrStatementVarStoreNameValue	::=
		"namevaluevarstore"	StringIdentifier	","
		{	"varid"	"="	Number	","	}
		(	"name"	"="	getStringId	","	)+
		"guid"	"="	guidDefinition	";

例：

 //
  // Define a Name/Value Storage (EFI_IFR_VARSTORE_NAME_VALUE)
  //
  namevaluevarstore MyNameValueVar,                // Define storage reference name in vfr
    name = STRING_TOKEN(STR_NAME_VALUE_VAR_NAME0), // Define Name list of this storage, refer it by MyNameValueVar[0]
    name = STRING_TOKEN(STR_NAME_VALUE_VAR_NAME1), // Define Name list of this storage, refer it by MyNameValueVar[1]
    name = STRING_TOKEN(STR_NAME_VALUE_VAR_NAME2), // Define Name list of this storage, refer it by MyNameValueVar[2]
    guid = IPMI_CONFIG_FORMSET_GUID;             // GUID of this Name/Value storage

控制语句

VFR文件中可以包含如下的控制语句

  • FormSet DisableIf Definition
    DisableIf语句，定义如下：
vfrStatementDisableIfFormSet	::=
	"disableif"	vfrStatementExpression	";"
			vfrFormSetList
	"endif"	";"

例：

disableif ideqval MyIfrNVData.SuppressGrayOutSomething == 0x2;
      orderedlist
        varid       = MyIfrNVData.OrderedList,
        prompt      = STRING_TOKEN(STR_TEST_OPCODE),
        help        = STRING_TOKEN(STR_TEXT_HELP),
        flags       = RESET_REQUIRED,
        option text = STRING_TOKEN(STR_ONE_OF_TEXT1), value = 3, flags = 0;
        option text = STRING_TOKEN(STR_ONE_OF_TEXT2), value = 2, flags = 0;
        option text = STRING_TOKEN(STR_ONE_OF_TEXT3), value = 1, flags = 0;
        default     = {1,2,3},
      endlist;
  endif;
  • FormSet SuppressIf Definition

SuppressIf语句，定义如下：

vfrStatementSuppressIfFormSet	::=
		"suppressif"	vfrStatementExpression	";"
				vfrFormSetList
		"endif"	";"

例：

 suppressif ideqval MyIfrNVData.BootOrderLarge == 0;
    form formid = 2,               // SecondSetupPage,
      title = STRING_TOKEN(STR_FORM2_TITLE);  // note formid is a variable (for readability) (UINT16) - also added Form to the line to signify the Op-Code
……
endif
  • Statement GrayOutIf Definition

GrayOutIf语句，定义如下：

vfrStatementGrayOutIfStat	::=
		"grayoutif"	vfrStatementExpression	";"
		(	vfrStatementStatList	)*
		"endif"	";"

例如：

grayoutif  match2 (stringref(STRING_TOKEN(STR_PATTERN)), stringref(STRING_TOKEN(STR_STRING)), PERL_GUID);
      numeric 
        varid   = MyIfrNVData.Match2,
        prompt  = STRING_TOKEN(STR_MATCH2_PROMPT),
        help    = STRING_TOKEN(STR_MATCH2_HELP),
        minimum = 0,
        maximum = 243,
      endnumeric;
    endif;

需要注意几点：

  1. if条件之后有一个分号；

  2. 最后有一个endif与之对应；

  • Goto Statement Definition

goto 语句

vfrStatementGoto	::=
		"goto"
		{
				(
						"devicePath"		"="	getStringId	","
						"formsetguid"	"="	guidDefinition	","
						"formid"			"="	Number	","
						"question"	"="	Number	","
				)
				|
				(
						"formsetguid"	"="	guidDefinition	","
						"formid"			"="	Number	","
						"question"	"="	Number	","
				)
				|
				(
						"formid"			"="	Number	","
						"question"	"="
						(
										StringIdentifier	","
								|	Number	","
						)
				)
	|
				(
						Number	","
				)
		}
		vfrQuestionHeader
		{	","	"flags"	"="	vfrGotoFlags	}
		{	","	"key"	"="	Number	}
		{	","	vfrStatementQuestionOptionList	}
		";"
vfrGotoFlags	::=
		gotoFlagsField	(	"|"	gotoFlagsField	)*
gotoFlagsField	::=
				Number
		|	questionheaderFlagsField

key 是使用的question ID

例：
生成没有key的 EFI_IFR_REF

goto	1,
		prompt	=	STRING_TOKEN(STR_GOTO_PROMPT),
		help			=	STRING_TOKEN(STR_GOTO_HELP);

生成有key的 EFI_IFR_REF

goto	1,
		prompt	=	STRING_TOKEN(STR_GOTO_PROMPT),
		help			=	STRING_TOKEN(STR_GOTO_HELP);
		key				=	0x1234;

生成 EFI_IFR_REF2

goto
		formid			=	1,
		question	=	QuesttionRef,
		prompt			=	STRING_TOKEN(STR_GOTO_PROMPT),
		help					=	STRING_TOKEN(STR_GOTO_HELP);

生成 EFI_IFR_REF3

goto
		formsetguid	=	FORMSET_GUID,
		formid						=	1,
		question				=	QuesttionRef,
		prompt						=	STRING_TOKEN(STR_GOTO_PROMPT),
		help								=	STRING_TOKEN(STR_GOTO_HELP);

生成 EFI_IFR_REF4

goto
		devicepath		=	STRING_TOKEN(STR_DEVICE_PATH),
		formsetguid	=	FORMSET_GUID,
		formid						=	1,
		question				=	QuesttionRef,
		prompt						=	STRING_TOKEN(STR_GOTO_PROMPT),
		help								=	STRING_TOKEN(STR_GOTO_HELP);

生成EFI_IFR_REF5 没有 varid

goto
		prompt	=	STRING_TOKEN(STR_GOTO_PROMPT),
		help			=	STRING_TOKEN(STR_GOTO_HELP);

生成EFI_IFR_REF5 有 varid

goto
		varid			=	MySTestData.mFieldRef,
		prompt		=	STRING_TOKEN(STR_GOTO_PROMPT),
		help				=	STRING_TOKEN	STR_GOTO_HELP);
		default	=	FID;QID;GuidValue;STRING_TOKEN(STR_DEVICE_PATH),
		;

生成FI_IFR_REF 有 option code

goto	1,
		prompt	=	STRING_TOKEN(STR_GOTO_PROMPT),
		help			=	STRING_TOKEN(STR_GOTO_HELP),
		refresh	interval	=	3
		;

需要注意

  • Vfr不支持枚举，所以包含的.h中不能有枚举
  • 不支持数组大小做算数运算；
  • 包含的.h内容都会放到vfr.i 中，所以，包含的头文件一定要单一；

本文主要参考自《edk-ii-vfr-specification.pdf》和《Tiano+Setup+Design+Guide.pdfTiano+Setup+Design+Guide.pdf》,详细可以查看源文档
也可以查看这里：EdkCompatibilityPkg/Sample/Tools/Source/VfrCompile/VfrCompile.g

90geek
关注
  • 4
    点赞
  • 踩
  • 16
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
专栏目录
UEFI驱动程序的研究与开发
08-31
UEFI是Intel推出的新一代BIOS技术。在分析UEFI基本结构和驱动程序模型的基础上，详细论述了基于USB协议栈的CC2531 ZigBee模块的设备驱动程序设计与开发过程，实现了在操作系统启动之前主机与USB设备间的信息交互，扩展了UEFI的功能。
UEFI GOP资料分享
12-28
3. **UEFI与传统BIOS对比**：分析了UEFI相对于BIOS的改进之处，包括性能提升、安全增强等方面的比较。 4. **UEFI配置和调试**：指导用户如何通过UEFI设置来优化系统性能，以及如何调试UEFI相关问题。 通过学习这些...
【UEFI实战】UEFI用户交互界面使用说明之VFR文件
热门推荐
jiangwei0512的博客
04-07 7万+
【UEFI实战】UEFI用户交互界面使用说明之VFR文件。
UEFI Setup界面Hii动态创建选项
qq_43561214的博客
02-26 1107
每个界面的选项一些操作 恢复默认值 动态创建的选项需要配置对应的当前值或者BufferStorage的值进行显示和存取操作，CallBack针对选项的操作进行执行CallBacFunc函数,其中实例需要自己实现每个vfr都可以按照需求实现自己的ConfigAccess Protocol。使用form formid 点击goto选项会跳到相同的formid页面。1.Vfr文件中建立Label ，在C文件中动态插入选项到Label位置。实例：这样就实现在vfr中跳转到不同的Form页面。
UEFI中的edk2编译流程_edk2代码走读
最新发布
m0_60707660的博客
05-17 1018
为了做好运维面试路上的助攻手，特整理了上百道，让你面试不慌心不跳，高薪offer怀里抱！这次整理的面试题，本份面试集锦涵盖了1、什么是运维?2、在工作中，运维人员经常需要跟运营人员打交道，请问运营人员是做什么工作的?3、现在给你三百台服务器，你怎么对他们进行管理?4、简述raid0 raid1raid5二种工作模式的工作原理及特点5、LVS、Nginx、HAproxy有什么区别?工作中你怎么选择?6、Squid、Varinsh和Nginx有什么区别，工作中你怎么选择?
浅谈UEFI中VFR文件开发
qq_33559839的博客
03-24 2280
废话不谈,通过三个实际的开发项目,分享一下VFR开发过程中的心得和应该注意的问题: 1.Set Data And Time 龙芯4000上的实现的原理： 之前4000上是在BdsDxe中实现的，熟悉Loongson平台的4000的话，我们不难看的出来： 设置时间和日期的功能是在BdsDxe/BootMaint/BootMaint.c中调用BootMaintCallback实现的。 在BootMaintCallback，会通过检测相关的QuestionId来进行不同的动作，比如说: case FORM
【UEFI实战】HII之vfr文件
技术联盟
03-23 335
https://blog.csdn.net/jiangwei0512/article/details/122824342
UEFI开发探索60-VFR文件和其他资源文件1（在BIOS setup上增加项）
06-27 5486
@[toc] (请保留-> 作者: 罗冰 https://blog.csdn.net/luobing4365) 如何使用VFR文件，是我这一段时间比较感兴趣的课题。包括VFR文件在内，UNI文件、IDF文件，都属于资源文件。UNI文件的使用，在之前Hii的例子中，已经讨论过了。而如何使用VFR文件，一直没有涉及到。 接下来的几篇博客，将以修改BIOS Setup（当然，还是以OvmfPkg编译的镜像来做BIOS文件）为例，演示如何使用VFR文件和相关的资源文件。 图1 OVMF镜像的B..
UEFI--form之间的关系（驱动调用）
技术联盟
03-22 115
顶层AdvancedManager.c。
所有的UEFI Spec文档
03-24
UEFI（统一可扩展固件接口）是一种标准的固件接口，用于替代传统的BIOS，以提供更现代、更安全且更高效的启动流程。UEFI规范由UEFI论坛制定，旨在提升系统的启动速度、增强安全性，并支持更大容量的存储设备。这个...
UEFI Specification.rar
09-03
UEFI（统一可扩展固件接口）是一种现代计算机硬件初始化的标准，它替代了传统的BIOS（基本输入输出系统），提供了一种更加现代化、安全且高效的方式来启动操作系统和管理硬件。UEFI规范旨在改进系统的启动过程，提高...
UEFI bios setup
01-06
URFI BIOS SETUP CONFIG == INIT INIT START STOP
uefi dec spec
06-14
UEFI DEC Spec概述 UEFI（Unified Extensible Firmware Interface）是一种firmware接口规范，用于取代传统的BIOS（Basic Input/Output System）。DEC（Device and Embedded Controller）spec是UEFI firmware开发中...
uefi dsc spec
06-14
UEFI DSC Spec UEFI DSC（Device Specific Configuration）spec是EDK II（Extensible Firmware Interface）平台描述文件的specification，用于描述基于UEFI firmware的平台配置。该spec主要用于指导开发者创建符合...
UEFI原理与编程实践--GUI之Setup界面分析一
Anthony的博客
11-29 6019
formset &endformset 表单集，Setup设置界面的一个页面，该页面内的内容都需要放在表单集内 Example: formset guid = MAIN_FORM_SET_GUID, title = STRING_TOKEN(STR_MAIN), help = STRING_TOKEN(STR_MAIN_HELP), class = MAIN_FORM_SET_CLASS, subclass = 0,
UEFI 界面实例解析
Anthony的博客
05-15 2515
如果不加判断，直接不可选，那么可以这么写 grayoutif TRUE;INTERACTIVE，意味人机交互，也就是可以动作的，通过这个key去进行操作，这种形式选中后按Enter就是执行操作，先理解三个函数，ExtractConfig，导出配置，RouteConfig，存储配置，CallBack，操作Hii数据。， C文件中保留重要的函数就行，仿照其他第三方驱动，这些驱动以Library形式在DSC文件中被包入，这样就新增了一个页面，在DeviceManager页面，还有一种驱动，这种是独立的驱动。
AMI bios 最简单的 setup中建立选项
dp__mcu的专栏
06-01 3893
https://blog.csdn.net/u013983194/article/details/79458422 参考文章 感谢博主无私奉献 ShellBinPkgNew.sdl TOKEN Name = "ShellBinPkg_SUPPORT" Value = "1" Help = "Main switch to enable ShellBinPkg support in Project" TokenType = Boolean TargetEQU = Yes Targ.
uefi实战：hii之vfr文件
07-15
UEFI（统一的可扩展固件接口）是一种用于替代传统BIOS的固件接口标准。HII（Human Interface Infrastructure）是UEFI中的一个组件，用于提供用户交互的图形界面。 VFR（Visual Forms Representation）文件是HII的一种文件格式，用于定义图形界面的布局和控件。VFR文件使用一种类似于C语言的语法来描述界面的结构和行为。 在实战中，您可以使用VFR文件来定义UEFI固件中的用户界面。首先，您需要创建一个VFR文件，其中包含界面的布局和控件的定义。然后，使用编译器将VFR文件编译为对应的二进制格式，生成一个可执行的HII包。最后，将HII包加载到UEFI固件中，使得固件能够使用VFR文件定义的界面。 通过使用VFR文件，您可以创建各种类型的用户界面，如菜单、对话框、输入框等。您可以定义控件的位置、大小、样式和行为，并与固件中的功能进行交互。 请注意，UEFI开发涉及复杂的技术和工具链。如果您对UEFI开发不熟悉，建议参考UEFI规范、开发工具和相关文档，以便更好地理解和应用HII和VFR文件。
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值