【UEFI基础】System Table（一）

最新推荐文章于 2024-09-10 16:19:58 发布
最新推荐文章于 2024-09-10 16:19:58 发布
阅读量3.1k 收藏 11
点赞数
分类专栏： UEFI基础知识 文章标签： uefi
原文链接：https://blog.csdn.net/jiangwei0512/article/details/51627562
版权

System Table

System Table是UEFI软件架构中最重要的一个部分，基本的代码都离不开它。

下面是一个基本的UEFI模块中会包含的Entry Point，它就有一个参数是System Table：

typedef
EFI_STATUS
(EFIAPI *EFI_IMAGE_ENTRY_POINT) (
  IN EFI_HANDLE ImageHandle, 
  IN EFI_SYSTEM_TABLE *SystemTable 
);
以8254Timer这个模块为例，它的inf模块中有以下的代码：

[Defines]
  INF_VERSION                    = 0x00010005
  BASE_NAME                      = Timer
  MODULE_UNI_FILE                = Timer.uni
  FILE_GUID                      = f2765dec-6b41-11d5-8e71-00902707b35e
  MODULE_TYPE                    = DXE_DRIVER
  VERSION_STRING                 = 1.0
 
  ENTRY_POINT                    = TimerDriverInitialize

其中的ENTRY_POINT就指向了该模块的入口：

/**
  Initialize the Timer Architectural Protocol driver
  @param ImageHandle     ImageHandle of the loaded driver
  @param SystemTable     Pointer to the System Table
  @retval EFI_SUCCESS            Timer Architectural Protocol created
  @retval EFI_OUT_OF_RESOURCES   Not enough resources available to initialize driver.
  @retval EFI_DEVICE_ERROR       A device error occured attempting to initialize the driver.
**/
EFI_STATUS
EFIAPI
TimerDriverInitialize (
  IN EFI_HANDLE        ImageHandle,
  IN EFI_SYSTEM_TABLE  *SystemTable
  )
{

后续的代码会使用到SystemTable中包含的内容。

System Table包含了一系列的指针，指向Console设备，指向Runtime Service Table，Boot Service Table、DXE Service Table和Configuration Table，前两张表包含了很多的基础函数，最后一张表包含了ACPI、SMBIOS等表。

参考目录\MdePkg\Include\Uefi\UefiSpec.h里面有system table的描述：

///
/// EFI System Table
///
typedef struct {
  ///
  /// The table header for the EFI System Table.
  ///
  EFI_TABLE_HEADER                  Hdr;
  ///
  /// A pointer to a null terminated string that identifies the vendor
  /// that produces the system firmware for the platform.
  ///
  CHAR16                            *FirmwareVendor;
  ///
  /// A firmware vendor specific value that identifies the revision
  /// of the system firmware for the platform.
  ///
  UINT32                            FirmwareRevision;
  ///
  /// The handle for the active console input device. This handle must support
  /// EFI_SIMPLE_TEXT_INPUT_PROTOCOL and EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL.
  ///
  EFI_HANDLE                        ConsoleInHandle;
  ///
  /// A pointer to the EFI_SIMPLE_TEXT_INPUT_PROTOCOL interface that is
  /// associated with ConsoleInHandle.
  ///
  EFI_SIMPLE_TEXT_INPUT_PROTOCOL    *ConIn;
  ///
  /// The handle for the active console output device.
  ///
  EFI_HANDLE                        ConsoleOutHandle;
  ///
  /// A pointer to the EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL interface
  /// that is associated with ConsoleOutHandle.
  ///
  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL   *ConOut;
  ///
  /// The handle for the active standard error console device.
  /// This handle must support the EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.
  ///
  EFI_HANDLE                        StandardErrorHandle;
  ///
  /// A pointer to the EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL interface
  /// that is associated with StandardErrorHandle.
  ///
  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL   *StdErr;
  ///
  /// A pointer to the EFI Runtime Services Table.
  ///
  EFI_RUNTIME_SERVICES              *RuntimeServices;
  ///
  /// A pointer to the EFI Boot Services Table.
  ///
  EFI_BOOT_SERVICES                 *BootServices;
  ///
  /// The number of system configuration tables in the buffer ConfigurationTable.
  ///
  UINTN                             NumberOfTableEntries;
  ///
  /// A pointer to the system configuration tables.
  /// The number of entries in the table is NumberOfTableEntries.
  ///
  EFI_CONFIGURATION_TABLE           *ConfigurationTable;
} EFI_SYSTEM_TABLE;

System Table的建立

System Table的建立是在DXE阶段(所以在这之前的PEI阶段并没有，里面提供的基础函数也不能用)，具体的代码在DxeMain.c中，下面列出简单的代码：

EFI_SYSTEM_TABLE mEfiSystemTableTemplate = {
  {
    EFI_SYSTEM_TABLE_SIGNATURE,                                           // Signature
    EFI_SYSTEM_TABLE_REVISION,                                            // Revision
    sizeof (EFI_SYSTEM_TABLE),                                            // HeaderSize
    0,                                                                    // CRC32
    0                                                                     // Reserved
  },
  NULL,                                                                   // FirmwareVendor
  0,                                                                      // FirmwareRevision
  NULL,                                                                   // ConsoleInHandle
  NULL,                                                                   // ConIn
  NULL,                                                                   // ConsoleOutHandle
  NULL,                                                                   // ConOut
  NULL,                                                                   // StandardErrorHandle
  NULL,                                                                   // StdErr
  NULL,                                                                   // RuntimeServices
  &mBootServices,                                                         // BootServices
  0,                                                                      // NumberOfConfigurationTableEntries
  NULL                                                                    // ConfigurationTable
};
  //
  // Allocate the EFI System Table and EFI Runtime Service Table from EfiRuntimeServicesData
  // Use the templates to initialize the contents of the EFI System Table and EFI Runtime Services Table
  //
  gDxeCoreST = AllocateRuntimeCopyPool (sizeof (EFI_SYSTEM_TABLE), &mEfiSystemTableTemplate);
  ASSERT (gDxeCoreST != NULL);
 
  gDxeCoreRT = AllocateRuntimeCopyPool (sizeof (EFI_RUNTIME_SERVICES), &mEfiRuntimeServicesTableTemplate);
  ASSERT (gDxeCoreRT != NULL);
 
  gDxeCoreST->RuntimeServices = gDxeCoreRT;

在System Table中需要特别介绍的就是Boot Service Table和Runtime Service Table，在UEFI开发中一定会用到其中提供的函数。

Boot Service Table

它主要分为以下的几类：

与事件相关的：

函数名类型函数描述
CreateEventBootCreates a general-purpose event structure
CreateEventExBootCreates an event structure as part of an event group
CloseEventBootCloses and frees an event structure
SignalEventBootSignals an event
WaitForEventBootStops execution until an event is signaled
CheckEventBootChecks whether an event is in the signaled state
SetTimerBootSets an event to be signaled at a particular time
RaiseTPLBootRaises the task priority level
RestoreTPLBootRestores/lowers the task priority level

与内存相关的：

函数名类型函数描述
AllocatePagesBootAllocates pages of a particular type.
FreePagesBootFrees allocated pages.
GetMemoryMapBootReturns the current boot services memory map and memory map key.
AllocatePoolBootAllocates a pool of a particular type.
FreePoolBootFrees allocated pool.

与Protocol相关的：

函数名类型函数描述
InstallProtocolInterfaceBootInstalls a protocol interface on a device handle.
UninstallProtocolInterfaceBootRemoves a protocol interface from a device handle.
ReinstallProtocolInterfaceBootReinstalls a protocol interface on a device handle.
RegisterProtocolNotifyBootRegisters an event that is to be signaled whenever an interface is installed for a specified protocol.
LocateHandleBootReturns an array of handles that support a specified protocol.
HandleProtocolBootQueries a handle to determine if it supports a specified protocol.
LocateDevicePathBootLocates all devices on a device path that support a specified protocol and returns the handle to the device that is closest to the path.
OpenProtocolBootAdds elements to the list of agents consuming a protocol interface.
CloseProtocolBootRemoves elements from the list of agents consuming a protocol interface.
OpenProtocolInformationBootRetrieve the list of agents that are currently consuming a protocol interface.
ConnectControllerBootUses a set of precedence rules to find the best set of drivers to manage a controller.
DisconnectControllerBootInforms a set of drivers to stop managing a controller.
ProtocolsPerHandleBootRetrieves the list of protocols installed on a handle. The return buffer is automatically allocated.
LocateHandleBufferBootRetrieves the list of handles from the handle database that meet the search criteria. The return buffer is automatically allocated.
LocateProtocolBootFinds the first handle in the handle database the supports the requested protocol.
InstallMultipleProtocolInterfacesBootInstalls one or more protocol interfaces onto a handle.
UninstallMultipleProtocolInterfacesBootUninstalls one or more protocol interfaces from a handle.

与Image相关的：

函数名类型函数描述
LoadImageBootLoads an EFI image into memory.
StartImageBootTransfers control to a loaded image’s entry point.
UnloadImageBootUnloads an image.
EFI_IMAGE_ENTRY_POINTBootPrototype of an EFI Image’s entry point.
ExitBootExits the image’s entry point.
ExitBootServicesBootTerminates boot services.

及其它：

函数名类型函数描述
SetWatchDogTimerBootResets and sets a watchdog timer used during boot services time.
StallBootStalls the processor.
CopyMemBootCopies the contents of one buffer to another buffer.
SetMemBootFills a buffer with a specified value.
GetNextMonotonicCountBootReturns a monotonically increasing count for the platform.
InstallConfigurationTableBootAdds, updates, or removes a configuration table from the EFI System Table.
CalculateCrc32BootComputes and returns a 32-bit CRC for a data buffer.

Runtime Service Table

在Boot Service中有一个ExitBootServices，还函数被调用后Boot Serice Table中的函数就不能再使用了，但是Runtime Service Table中的函数仍然可以使用，这些函数在OS中也仍旧可以调用，当然前提是OS支持。

Runtime Serivces有以下几类：

与变量相关的：

函数名类型函数描述
GetVariableRuntimeReturns the value of a variable.
GetNextVariableNameRuntimeEnumerates the current variable names.
SetVariableRuntimeSets the value of a variable.
QueryVariableInfoRuntimeReturns information about the EFI variables

与时间相关的：

函数名类型函数描述
GetTimeRuntimeReturns the current time and date, and the time-keeping capabilities of the platform.
SetTimeRuntimeSets the current local time and date information.
GetWakeupTimeRuntimeReturns the current wakeup alarm clock setting.
SetWakeupTimeRuntimeSets the system wakeup alarm clock time.

与虚拟内存相关的：

函数名类型函数描述
SetVirtualAddressMapRuntimeUsed by an OS loader to convert from physical addressing to virtual addressing.
ConvertPointerRuntimeUsed by EFI components to convert internal pointers when switching to virtual addressing.

及其它：

函数名类型函数描述
GetNextHighMonotonicCountRuntimeReturns the next high 32 bits of the platform’s monotonic counter.
ResetSystemRuntimeResets the entire platform.
UpdateCapsuleRuntimePass capsules to the firmware. The firmware may process the capsules immediately or return a value to be passed into ResetSystem() that will cause the capsule to be processed by the firmware as part of the reset process.
QueryCapsuleCapabilitiesRuntimeReturns if the capsule can be supported via UpdateCapsule()

Runtime Service与Boot Service不同，它并不是在DxeMain.c中直接建立好的，它刚开始基本上是一个空的表：

EFI_RUNTIME_SERVICES mEfiRuntimeServicesTableTemplate = {
  {
    EFI_RUNTIME_SERVICES_SIGNATURE,                               // Signature
    EFI_RUNTIME_SERVICES_REVISION,                                // Revision
    sizeof (EFI_RUNTIME_SERVICES),                                // HeaderSize
    0,                                                            // CRC32
    0                                                             // Reserved
  },
  (EFI_GET_TIME)                    CoreEfiNotAvailableYetArg2,   // GetTime
  (EFI_SET_TIME)                    CoreEfiNotAvailableYetArg1,   // SetTime
  (EFI_GET_WAKEUP_TIME)             CoreEfiNotAvailableYetArg3,   // GetWakeupTime
  (EFI_SET_WAKEUP_TIME)             CoreEfiNotAvailableYetArg2,   // SetWakeupTime
  (EFI_SET_VIRTUAL_ADDRESS_MAP)     CoreEfiNotAvailableYetArg4,   // SetVirtualAddressMap
  (EFI_CONVERT_POINTER)             CoreEfiNotAvailableYetArg2,   // ConvertPointer
  (EFI_GET_VARIABLE)                CoreEfiNotAvailableYetArg5,   // GetVariable
  (EFI_GET_NEXT_VARIABLE_NAME)      CoreEfiNotAvailableYetArg3,   // GetNextVariableName
  (EFI_SET_VARIABLE)                CoreEfiNotAvailableYetArg5,   // SetVariable
  (EFI_GET_NEXT_HIGH_MONO_COUNT)    CoreEfiNotAvailableYetArg1,   // GetNextHighMonotonicCount
  (EFI_RESET_SYSTEM)                CoreEfiNotAvailableYetArg4,   // ResetSystem
  (EFI_UPDATE_CAPSULE)              CoreEfiNotAvailableYetArg3,   // UpdateCapsule
  (EFI_QUERY_CAPSULE_CAPABILITIES)  CoreEfiNotAvailableYetArg4,   // QueryCapsuleCapabilities
  (EFI_QUERY_VARIABLE_INFO)         CoreEfiNotAvailableYetArg4    // QueryVariableInfo
};

可以看到很多的CoreEfiNotAvailableYetxx。

Runtime Service需要在DXE阶段运行过程中一个个的填补。

比如关于时间的几个接口的初始化：

/**
  This is the declaration of an EFI image entry point. This can be the entry point to an application
  written to this specification, an EFI boot service driver, or an EFI runtime driver.
  @param  ImageHandle           Handle that identifies the loaded image.
  @param  SystemTable           System Table for this image.
  @retval EFI_SUCCESS           The operation completed successfully.
**/
EFI_STATUS
EFIAPI
InitializeRealTimeClock (
  IN EFI_HANDLE                            ImageHandle,
  IN EFI_SYSTEM_TABLE                      *SystemTable
  )
{
  EFI_STATUS  Status;
 
  LibRtcInitialize (ImageHandle, SystemTable);
 
  SystemTable->RuntimeServices->GetTime       = GetTime;
  SystemTable->RuntimeServices->SetTime       = SetTime;
  SystemTable->RuntimeServices->GetWakeupTime = GetWakeupTime;
  SystemTable->RuntimeServices->SetWakeupTime = SetWakeupTime;
 
  Status = gBS->InstallMultipleProtocolInterfaces (
                  &mHandle,
                  &gEfiRealTimeClockArchProtocolGuid,
                  NULL,
                  NULL
                  );
 
  return Status;
}
再比如关于变量的几个接口：

EFI_STATUS
EFIAPI
VariableServiceInitialize (
  IN EFI_HANDLE                         ImageHandle,
  IN EFI_SYSTEM_TABLE                   *SystemTable
  )
{
  EFI_STATUS                            Status;
  EFI_EVENT                             ReadyToBootEvent;
  EFI_EVENT                             EndOfDxeEvent;
 
  Status = VariableCommonInitialize ();
  ASSERT_EFI_ERROR (Status);
 
  Status = gBS->InstallMultipleProtocolInterfaces (
                  &mHandle,
                  &gEdkiiVariableLockProtocolGuid,
                  &mVariableLock,
                  NULL
                  );
  ASSERT_EFI_ERROR (Status);
 
  Status = gBS->InstallMultipleProtocolInterfaces (
                  &mHandle,
                  &gEdkiiVarCheckProtocolGuid,
                  &mVarCheck,
                  NULL
                  );
  ASSERT_EFI_ERROR (Status);
 
  SystemTable->RuntimeServices->GetVariable         = VariableServiceGetVariable;
  SystemTable->RuntimeServices->GetNextVariableName = VariableServiceGetNextVariableName;
  SystemTable->RuntimeServices->SetVariable         = VariableServiceSetVariable;
  SystemTable->RuntimeServices->QueryVariableInfo   = VariableServiceQueryVariableInfo;

————————————————
版权声明：本文为CSDN博主「jiangwei0512」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/jiangwei0512/article/details/51627562

Alix_sz
关注
专栏目录
UEFI基础——Protocol服务
大猫的博客
10-12 492
Protocol是UEFI中重要概念之一，Protocol在UEFI中的角色相当于UEFI的接口函数。实际上，Proctol是UEFI环境的提供者何使用者之间的一种约定，双方根据这个协定进行通信。
UEFI基础——测试用例Hello Word
大猫的博客
10-11 558
uefi学习
【UEFI基础】System Table和Architecture Protocols
热门推荐
jiangwei0512的博客
06-10 1万+
【UEFI基础】System Table和Architecture Protocols。
【UEFI Spec笔记】EFI System Table
Mutouyugi的博客
08-20 554
UEFI应用程序(UEFI Applications)，UEFI引导服务驱动程序(UEFI Drivers)和UEFI运行时驱动程序(UEFI Drivers)，UEFI应用程序包括UEFI操作系统加载程序(UEFI OS Loaders)，这三种image类型的入口参数如下。typedefEFI_STATUS后续有更深理解，会继续补充。学艺不精，错误请指正；如有侵权，请联系删除。参考文档： 《UEFI_Spec_2_9_2021_03_18》
SAP System Tables
dayishi2939的博客
05-26 163
System Tables ADCP Person/Address assignment (central address administration) ADIRACCESS Table t...
【UEFI基础】System Table(二)
humanof的专栏
11-03 564
参考WWW.LAB-Z.COM大神的操作来寻找一下System Table. 以OVMF 代码为例， 在 \MdeModulePkg\Core\Dxe\DxeMain\DxeMain.c 中可以查到。为了验证，我修改代码，在整个 Table 的最后面加上一个标记。 MemoryProfileInit (HobStart); // // Allocate the EFI System Table and EFI Runtime Service Table from EfiRuntimeServic
Oracle 系统表
weixin_34212762的博客
03-18 108
Below is an alphabetical listing of the Oracle system tables that are commonly used. System Table Description ALL_ARGUMENTS ...
UEFI——EFI Systable Table
weixin_45258382的博客
11-07 2101
别问图片为啥是两只猫，我也不知道~ 。我想找一个合适的文章标签的没有，然后还是带星必填，哦~好难受。等来日博客等级上三级，本姑娘我自定义一个，哼~
EDK UEFI System table详解
m0_37371619的博客
02-05 943
这边Table很重要， 参考了其他人的博客 和书 外加自己的一些理解 其中的ConIn->EFI_SIMPLE_TEXT_INPUT_PROTOCOL->详细使用方法（这个protocol的服务比较少） ...
介绍一下UEFI的system table
07-08
UEFI系统引导过程中使用了一个名为"System Table"的数据结构，它提供了有关系统硬件和固件的重要信息。 UEFI System Table是一个位于固件内存中的数据结构，由UEFI固件在启动时创建和填充。它包含了多个表项，每个...
UEFI基础——事件服务
大猫的博客
11-11 322
UEFI 事件服务包含事件（Event）、定时器（Timer）、任务优先级（TPL）三类服务。
linux System table
weixin_41028621的博客
05-13 406
学习linux kernel system table. 1.Symbols   In the context of programming, a symbol is the building block of a program: it is a variable name or a function name. It should be of no surprise that the ke...
UEFI基础概念1——EFI SYSTEM TABLE
最新发布
qq_44807736的博客
09-10 217
对UEFI应用程序和驱动程序开发人员来讲，系统表是最重要的数据结构之一，它是用户空间通往内核空间的通道。有了它，UEFI应用程序和驱动才可以访问UEFI内核、硬件资源和输入/输出设备。（1）在应用程序和驱动中如何访问系统表计算机系统进入DXE阶段后系统表被初始化，因而系统表只能用于DXE阶段以及以后的应用程序和驱动中。系统表是UEFI内核的一个全局结构体，其指针作为程序映像（Image）入口函数的参数传递到用户空间。
DB2 system table resource
程序员码工的专栏
11-11 534
-- CHECK USER TABLES SELECT NAME FROM SYSIBM.SYSTABLES WHERE CREATEDBY = CURRENT_SCHEMA SELECT NAME FROM SYSIBM.SYSTABLES WHERE CREATEDBY = '' -- CHECK TABLE COLUMNS INFORMATION SELECT NAME,
02_基本的UEFI架構
ymzhou117的专栏
12-19 1240
转自：http://blog.yam.com/wttmama/article/33757450 在 EFI 中，有一些基本的觀念必須先建立 先知道一些觀念、結構，有助於後續的理解。 幾個EFI的重要角色要記得 1. System Table : 含有很多重要的資料結構以及系統 function 的 interface。 2. Handle Database and proto
【UEFI实战】EFI System Table中的输入输出
技术联盟
05-09 861
gEfiSimpleTextOutProtocolGuid的安装对应到不同的情况，比如对于串口就需要有gEfiSerialIoProtocolGuid，对于显示器就需要依赖于gEfiUgaDrawProtocolGuid或者gEfiGraphicsOutputProtocolGuid等与图形输出有关的protocols。这里有一个循环，可以起到多个位置打印的效果，而ConSplitterTextOutAddDevice()可以增加输出位置。DEBUG，它一般通过串口输出，这个是调试的时候最常用的；
UEFI开发学习6 - Protocol的创建
技术联盟
03-18 849
顾名思义，前者是只安装一个ProtocolInterface，后者可以安装一个或多个ProtocolInterface，此外，InstallMultipleProtocolInterfaces()比InstallProtocolInterface()执行更多的错误检查，因此规范建议使用InstallMultipleProtocolInterfaces()。Interface： 一个指向协议接口的指针。Handle： 指向要在上面安装新协议接口的句柄的指针，或者如果要分配新句柄，则指向NULL。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值