使用者工具

網站工具


uefi_learning

差異處

這裏顯示兩個版本的差異處。

連向這個比對檢視

Both sides previous revision 前次修改
下次修改
前次修改
uefi_learning [2024/04/07 11:24]
don
uefi_learning [2024/04/30 08:27] (目前版本)
don
行 1: 行 1:
 ====== UEFI 學習 ====== ====== UEFI 學習 ======
 +
 +[[https://uefi.org/specifications | UEFI specification download]]
 +
  
 {{:uefi_flow1.png|}} {{:uefi_flow1.png|}}
行 27: 行 30:
 |[FeaturePcd]| 用於列出本模塊用到的Pcd 常量| |[FeaturePcd]| 用於列出本模塊用到的Pcd 常量|
 |[PatchPcd]| 列出的Pcd 變量僅本模塊可用| |[PatchPcd]| 列出的Pcd 變量僅本模塊可用|
 +
 +[[http://guidgen.com|GUID 的生成]]
  
 1、[Defines]塊: 1、[Defines]塊:
行 69: 行 74:
  
 5、[BuildOptions]塊:\\ 5、[BuildOptions]塊:\\
-1、語法: +5-1、語法: 
-[BuildOptions]\\ +     [BuildOptions] 
-[編譯器家族] : [$ (Target)][Tool_CHAIN_TAG][$ (Arch)]_[CC | DLINK]_FLAGS [= |==]選項\\+     [編譯器家族] : [$ (Target)][Tool_CHAIN_TAG][$ (Arch)]_[CC | DLINK]_FLAGS [= |==]選項
  
-2、編譯器家族可以是MSFT(Visual Studio編譯器家族)、INTEL(Intel編譯器家族)、GCC(Gcc編譯器家族)和 RVCT(ARM編譯器家族)中的一個\\ +5-2、編譯器家族 
-Target是DEBUG、RELEASE和*中的一個,*是萬用字元\\ +     可以是MSFT(Visual Studio編譯器家族)、INTEL(Intel編譯器家族)、GCC(Gcc編譯器家族) 
-TOOL_CHAIN_TAG是編譯器的名字,編譯器定義在Conf/tools_def.txt檔中,*表示對指定編譯器家族內的所有編譯器都有效\\ +     和 RVCT(ARM編譯器家族)中的一個 
-Arch是體系結構,可以是IA32、X64、IPF、EBC或ARM,*是萬用字元\\ +     Target是DEBUG、RELEASE和*中的一個,*是萬用字元 
-CC表示編譯選項,DLINK表示連結選項\\ +     TOOL_CHAIN_TAG是編譯器的名字,編譯器定義在Conf/tools_def.txt檔中,*表示對指定編譯器家族內的所有編譯器都有效 
-=表示選項附加到預設選項後面,==表示僅使用所定義的選項,不用預設選項。它們後面是編譯選項或連接選項\\+     Arch是體系結構,可以是IA32、X64、IPF、EBC或ARM,*是萬用字元 
 +     CC表示編譯選項, 
 +     DLINK表示連結選項 
 +     =表示選項附加到預設選項後面, 
 +     ==表示僅使用所定義的選項,不用預設選項。它們後面是編譯選項或連接選項 
 + 
 + 
 +==== inf檔編譯運行 ==== 
 + 
 +原始檔案,inf工程檔完成,想要編譯運行這個模組,需要將inf工程檔添加到dsc的[Components]部分,然後就可以使用build工具編譯\\ 
 +模組應用程式是如何被編譯成.efi文件的:\\ 
 +1、.c源碼檔先被編譯成目的檔案.obj\\ 
 +2、連接器將目的檔案*.obj和其他的庫連接成*.dll\\ 
 +3、GenFw工具將*.dll轉化成*.efi\\ 
 +這些過程都由build命令自動完成\\ 
 + 
 +標準應用程式載入過程(efi檔載入)\\ 
 +1、將efi檔載入到記憶體\\ 
 +efi模組檔————gBS ->LoadImage()將efi檔載入到記憶體中生成image物件————gBS->StartImage(Image)啟動Image物件\\ 
 + 
 +  * gBS 指向啟動服務表 global Boot Servers\\ 
 +  * gST 指向系統表 global System Table\\ 
 +  * gRT 指向運行時服務表 global Running Time\\ 
 +  * gImageHandle 指向正在執行的驅動或應用程式\\
  
 <code> <code>
-[BuildOptions] +EFI_STATUS 
-  # Enable STDARG for variable arguments +LoadDriver( 
-  *_*_*_CC_FLAGS = -DHAVE_STDARG_H+  IN CONST CHAR16   *FileName, 
 +  IN CONST BOOLEAN  Connect 
 +  ) 
 +
 +  EFI_HANDLE                    LoadedDriverHandle; 
 +  EFI_STATUS                    Status; 
 +  EFI_DEVICE_PATH_PROTOCOL      *FilePath; 
 +  EFI_LOADED_IMAGE_PROTOCOL     *LoadedDriverImage;
  
-  # Override MSFT build option to remove /Oi and /GL +  LoadedDriverImage   = NULL; 
-  MSFT:*_*_*_CC_FLAGS          /GL- +  FilePath            = NULL; 
-  INTEL:*_*_*_CC_FLAGS         /Oi-+  LoadedDriverHandle  NULL; 
 +  Status              EFI_SUCCESS;
  
-  # Oniguruma: potentially uninitialized local variable used +*************************************
-  MSFT:*_*_*_CC_FLAGS = /wd4701 /wd4703+
  
-  # Oniguruma: intrinsic function not declared +  // 
-  MSFT:*_*_*_CC_FLAGS = /wd4164+  // Use LoadImage to get it into memory 
 +  // 
 +  Status = gBS->LoadImage( 
 +    FALSE, 
 +    gImageHandle, 
 +    FilePath, 
 +    NULL, 
 +    0, 
 +    &LoadedDriverHandle);
  
-  # Oniguruma: old style declaration in st.c +**********************************************
-  MSFT:*_*_*_CC_FLAGS = /wd4131+
  
-  # Oniguruma: 'type cast' : truncation from 'OnigUChar *' to 'unsigned int' +    // 
-  MSFT:*_*_*_CC_FLAGS = /wd4305 /wd4306+    // Make sure it is a driver image 
 +    // 
 +    Status = gBS->HandleProtocol (LoadedDriverHandle, &gEfiLoadedImageProtocolGuid, (VOID *) &LoadedDriverImage);
  
-  # Oniguruma: nameless union declared in regparse.h + ************************************************* 
-  MSFT:*_*_*_CC_FLAGS = /wd4201+ /* 
 + * 找出可执行的程序镜像Image的入口函数并执行找到的入口函数, gBS->StartImage是个函数指针,实际指向CoreStartImage函数 
 + */ 
 +    Status gBS->StartImage(LoadedDriverHandle, NULL, NULL); 
 +    if (EFI_ERROR(Status)) { 
 +      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_LOAD_ERROR), gShellLevel2HiiHandle, FileName, Status); 
 +    } else { 
 +      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_LOAD_LOADED), gShellLevel2HiiHandle, FileName, LoadedDriverImage->ImageBase, Status); 
 +    } 
 +  } 
 +********************************************************** 
 +  return (Status); 
 +
 +</code>
  
-  # Oniguruma: 'type cast' : "int" to "OnigUChar", function pointer to "void *" +2、進入鏡像image的入口函數 
-  MSFT:*_*_*_CC_FLAGS = /wd4244 /wd4054+CoreStartImage的主要作用是調用鏡像的入口函數,在這裡面SetIump/LongJumps是為應用程式提供了一種錯誤處理機制。gBS->StartImage的核心是EntryPoint函數,它就是這個應用程式的入口函數,就是_ModuleEntryPoint函數,進入到這裡,代碼執行的控制權才轉交給我們的應用程式efi
  
-  # Oniguruma: previous local declaration +<code> 
-  MSFT:*_*_*_CC_FLAGS = /wd4456+EFI_STATUS 
 +EFIAPI 
 +CoreStartImage ( 
 +  IN EFI_HANDLE  ImageHandle, 
 +  OUT UINTN      *ExitDataSize, 
 +  OUT CHAR16     **ExitData  OPTIONAL 
 +  ) 
 +
 +  EFI_STATUS                    Status; 
 +  LOADED_IMAGE_PRIVATE_DATA     *Image; 
 +  LOADED_IMAGE_PRIVATE_DATA     *LastImage; 
 +  UINT64                        HandleDatabaseKey; 
 +  UINTN                         SetJumpFlag; 
 +  EFI_HANDLE                    Handle;
  
-  # Oniguruma: signed and unsigned mismatch/cast +************************************************************** 
-  MSFT:*_*_*_CC_FLAGS = /wd4018 /wd4245 /wd4389+  // 
 +  // Set long jump for Exit() support 
 +  // JumpContext must be aligned on a CPU specific boundary. 
 +  // Overallocate the buffer and force the required alignment 
 +  /
 +  Image->JumpBuffer AllocatePool (sizeof (BASE_LIBRARY_JUMP_BUFFER) + BASE_LIBRARY_JUMP_BUFFER_ALIGNMENT); 
 +  if (Image->JumpBuffer == NULL) { 
 +    // 
 +    // Image may be unloaded after return with failure, 
 +    // then ImageHandle may be invalid, so use NULL handle to record perf log. 
 +    // 
 +    PERF_START_IMAGE_END (NULL);
  
-  # Oniguruma: tag_end in parse_callout_of_name +    // 
-  GCC:*_*_*_CC_FLAGS = -Wno-error=maybe-uninitialized+    // Pop the current start image context 
 +    // 
 +    mCurrentImage LastImage;
  
-  # Oniguruma: implicit conversion from 'UINTN' (aka 'unsigned long long') to 'long' +    return EFI_OUT_OF_RESOURCES; 
-  GCC:*_CLANG9_*_CC_FLAGS = -Wno-error=constant-conversion+  
 +  Image->JumpContext ALIGN_POINTER (Image->JumpBuffer, BASE_LIBRARY_JUMP_BUFFER_ALIGNMENT);
  
-  # Not add -Wno-error=maybe-uninitialized option for XCODE +  SetJumpFlag SetJump (Image->JumpContext); 
-  # XCODE doesn't know this option +  // 
-  XCODE:*_*_*_CC_FLAGS =+  // The initial call to SetJump() must always return 0. 
 +  // Subsequent calls to LongJump() cause a non-zero value to be returned by SetJump(). 
 +  // 
 +  if (SetJumpFlag == 0) { 
 +    RegisterMemoryProfileImage (Image, (Image->ImageContext.ImageType == EFI_IMAGE_SUBSYSTEM_EFI_APPLICATION ? EFI_FV_FILETYPE_APPLICATION EFI_FV_FILETYPE_DRIVER)); 
 +    // 
 +    // Call the image's entry point 核心 
 +    // 
 +    Image->Started TRUE; 
 +    Image->Status = Image->EntryPoint (ImageHandle, Image->Info.SystemTable);
  
 +******************************************************************
 +
 +  //
 +  // UEFI Specification - StartImage() - EFI 1.10 Extension
 +  // To maintain compatibility with UEFI drivers that are written to the EFI
 +  // 1.02 Specification, StartImage() must monitor the handle database before
 +  // and after each image is started. If any handles are created or modified
 +  // when an image is started, then EFI_BOOT_SERVICES.ConnectController() must
 +  // be called with the Recursive parameter set to TRUE for each of the newly
 +  // created or modified handles before StartImage() returns.
 +  //
 +
 +**********************************************************************
 +
 +  //
 +  // Save the Status because Image will get destroyed if it is unloaded.
 +  //
 +  Status = Image->Status;
 +
 +**************************************************************************
 +  //
 +  // Done
 +  //
 +  PERF_START_IMAGE_END (Handle);
 +  return Status;
 +}
 +
 +_ModuleEntryPoint函数:
 +
 +EFI_STATUS
 +EFIAPI
 +_ModuleEntryPoint (
 +  IN EFI_PEI_FILE_HANDLE       FileHandle,
 +  IN CONST EFI_PEI_SERVICES    **PeiServices
 +  )
 +{
 +  if (_gPeimRevision != 0) {
 +    //
 +    // Make sure that the PEI spec revision of the platform is >= PEI spec revision of the driver
 +    //
 +    ASSERT ((*PeiServices)->Hdr.Revision >= _gPeimRevision);
 +  }
 +
 +  //
 +  // Call constructor for all libraries
 +  //
 +  ProcessLibraryConstructorList (FileHandle, PeiServices);
 +
 +  //
 +  // Call the driver entry point
 +  //
 +  return ProcessModuleEntryPointList (FileHandle, PeiServices);
 +}
 </code> </code>
 +
 +3、進入模組的入口函數
 +在_ModuleEntryPoint中,調用了ProcessModuleEntryPointList ,然後在build過程中,會解析inf檔,生成AutoGen.c檔,裡面查看ProcessModuleEntryPointList ,它調用了應用程式工程模組的真正入口函數,就是inf檔中指定的那個入口函數
 +
 +<code>
 +EFI_STATUS
 +EFIAPI
 +ProcessModuleEntryPointList (
 +  IN       EFI_PEI_FILE_HANDLE  FileHandle,
 +  IN CONST EFI_PEI_SERVICES     **PeiServices
 +  )
 +
 +{
 +  return PcdPeimInit (FileHandle, PeiServices);
 +}
 +</code>
 +標準應用程式工程模組入口函式呼叫過程:\\
 +efi——LoadImage——StartImage——_ModuleEntryPoint——ProcessModuleEntryPointList ——inf中指定的入口函数\\
 +原文連結:https://blog.csdn.net/wangyongh/article/details/105345077
 +
 +
 +===== DSC 文件 =====
 +.inf 用于编译一个模块, 而.dsc 文件用于编译一个Package, 它包含了[Defines]、
 +[LibraryClasses]、[Components] 几个必需部分以及[PCD]、[BuildOptions] 等几个可选部分。
  
  
 +===== DEC 文件 =====
 +.dec 文件定义了公开的数据和接口,供其他模块使用。它包含了必需区块[Defines] 以及可选区块[Includes]、[LibraryClasses]、[Guids]、[Protocols]、[Ppis] 和[PCD] 几个部分。
 +.dec文件需要被调用模块.inf文件所包含。
  
  
行 180: 行 353:
 |FatPkg, FatBinPkg|FAT支持包。| \\                     |FatPkg, FatBinPkg|FAT支持包。| \\                    
 原文連結:https://blog.csdn.net/u011057409/article/details/117636656 原文連結:https://blog.csdn.net/u011057409/article/details/117636656
 +
 +
 +===== Build 參數 =====
 +
 +^ 命令參數縮寫 ^ 命令參數全稱 ^ 描述 ^
 +|-h |--help |show this help message and exit顯示説明資訊。|
 +|-a TARGETARCH |--arch=TARGETARCH|選擇目標平臺架構,該選項被指定會取代Conf/target.txt中的TARGET_ARCH。|
 +|-p PLATFORMFILE |--platform=PLATFORMFILE|通過指定.dsc檔指定要編譯的package,該選項將會Conf/target.txt文件ACTIVE_PLATFORM。|
 +|-m MODULEFILE| --module=MODULEFILE|Build the module specified by the INF file name argument。|
 +|-b BUILDTARGET| --buildtarget=BUILDTARGET |選擇編譯成DEBUG還是RELEASE。指定該選項後會取代target.txt文件中TARGET。|
 +|-t TOOLCHAIN| --tagname=TOOLCHAIN|選擇tools_def.txt中定義的編譯工具,例如VS2012:-t vs2012|
 +|-n THREADNUMBER| |編譯器使用的執行緒數量,指定後取代target.txt檔中MAX_CONCURRENT_THREAD_NUMBER指定的執行緒數量。 Less than 2 will disable multi-thread builds.小於2就禁止多執行緒編譯。|
 +|-u| --skip-autogen | Skip AutoGen step.跳過AutoGen這一步。|
 +|-c| --case-insensitive | Don't check case of file name.檔案名不區分大小寫。|
 +|-w| --warning-as-error | Treat warning in tools as error.將警告做錯誤處理。|
 +|-j LOGFILE| --log=LOGFILE| Put log in specified file as well as on console.將編譯資訊輸出到檔。|
 +|-s| --silent| Make use of silent mode of (n)make.使用沉默模式執行make或nmake。|
 +|-q| --quiet| Disable all messages except FATAL ERRORS.編譯過程中只顯示嚴重錯誤資訊。|
 +|-d DEBUG| --debug=DEBUG| Enable debug messages at specified level.在指定的級別啟用調試消息。|
 +|-D MACROS| --define=MACROS| Macro: "Name [= Value]".定義宏。|
 +| | ---version| show program's version number and exit。|
 +
  
 ===== UEFI API ===== ===== UEFI API =====
行 190: 行 385:
 ==== PcdGetPtr() ==== ==== PcdGetPtr() ====
 PcdGetPtr(PcdHelloWorldPrintString) 讀取在PcdHelloWorldPrintString 的字串。 PcdGetPtr(PcdHelloWorldPrintString) 讀取在PcdHelloWorldPrintString 的字串。
 +
 +==== AMI VEB ====
 +AMI VEB 基本上就是一堆 .CIF 檔案的集合
 +
 + 
uefi_learning.1712460260.txt.gz · 上一次變更: 2024/04/07 11:24 由 don