Windows10下，UEFI开发环境的搭建

最新推荐文章于 2023-05-30 19:52:05 发布

DDR内存测试

最新推荐文章于 2023-05-30 19:52:05 发布

阅读量1.9k

点赞数 1

分类专栏： UEFI

原文链接：https://www.cnblogs.com/jellify/p/9445486.html

版权

UEFI 专栏收录该内容

8 篇文章 4 订阅

订阅专栏

第一步：安装VS2015和EDK2018

参考：https://www.cnblogs.com/jellify/p/9445486.html

1. 安装2012及以上VS https://visualstudio.microsoft.com/

2.下载NASM 2.13.03 http://www.nasm.us/，默认安装目录为C:\nasm，同时添加到PATH环境变量中

3. 安装Python2.7.x https://www.python.org/，默认安装目录为C:\Python27，添加到新建的PYTHON_HOME环境变量中

4. 安装openssl http://wiki.overbyte.eu/arch/openssl-1.1.0g-win32.zip，默认安装目录为C:\openssl，添加到PATH环境变量中

5. 安装cygwin64 http://www.cygwin.com/，默认安装目录为C:\cygwin

6. 安装UDK2018 https://codeload.github.com/tianocore/edk2/zip/master ，首先创建一个工作目录，如D:\WorkSpace，将UDK解压到该工作目录下

7. 下载edk2-BaseTools https://codeload.github.com/tianocore/edk2-BaseTools-win32/zip/master

8. 下载openssl配置文件 https://codeload.github.com/openssl/openssl/zip/OpenSSL_1_1_0g

第二步：UDK配置

参考：https://www.cnblogs.com/jellify/p/9445486.html

1. 在..\edk2-vUDK2018\CryptoPkg\Library\OpensslLib\中，存在一个openssl目录，将其删除后，将openssl-OpenSSL_1_1_0g.zip解压到该目录下并重命名为openssl

2. 将edk2-BaseTools-win32-master.zip解压到..\uefi-workspace\edk2-vUDK2018\BaseTools\中，并重命名为Win32

3. 在..\uefi-workspace\edk2-vUDK2018\Conf\target.txt中修改TOOL_CHAIN_TAG为当前工具版本，如TOOL_CHAIN_TAG = VS2012x86

4. 在..\uefi-workspace\edk2-vUDK2018\目录下，可修改edksetup.bat来修改一些软件的安装位置

第三步：运行实例

参考：https://www.cnblogs.com/jellify/p/9445486.html

1. 打开cmd，到..\uefi-workspace\edk2-vUDK2018\目录下，先设定python位置，再进行初始化操作，最后进行build操作

　　>>set PYTHON_HOME=C:\Python27
　　>>edksetup.bat --nt32

2. 初始化结束后，进行build构建efi文件；在build结束后，..\uefi-workspace\edk2-vUDK2018\目录下会生成Build文件夹，..\Build\NT32IA32\DEBUG_VS2012x86\IA32\中存在一些初始的efi文件，如HelloWorld.efi文件

　　>>build

3.利用命令打开NT32模拟器（或者在..\uefi-workspace\edk2-vUDK2018\Build\NT32IA32\DEBUG_VS2012x86\IA32\目录下运行SecMain.exe），输入fs0：，然后输入efi文件名，运行efi文件（默认目录为..\uefi-workspace\edk2-vUDK2018\Build\NT32IA32\DEBUG_VS2012x86\IA32\）

　　>>build run 
　　>>fs0:
　　>>HelloWorld.efi

第四步：EFI应用的开发

参考：https://www.cnblogs.com/ScvQ/p/9474900.html

参考：http://www.cppblog.com/djxzh/archive/2012/03/13/167690.html

初识UEFI
按惯例，首先让我们用HelloWorld跟UEFI打个招呼吧
标准application

/*main.c */
#include <Uefi.h>
EFI_STATUS
UefiMain (
          IN EFI_HANDLE        ImageHandle,
          IN EFI_SYSTEM_TABLE  *SystemTable
          )
{
   SystemTable -> ConOut-> OutputString(SystemTable -> ConOut, L"HelloWorld\n");
   return EFI_SUCCESS;
}

有以下几点需要注意：
1。头文件，所有的UEFI程序都有include <Uefi.h>
2。 main函数， UEFI 基本Application的main函数是UefiMain
3。 main函数的返回值类型 EFI_STATUS。在UEFI中基本上所有的返回值类型都是EFI_STATUS。

它本质上是UINTN。

4。 main函数的参数。.efi 文件加载到内存后称为Image， ImageHandle 用来描述、访问、控制此Image。第二个参数是SystemTable，它是我们的程序同UEFI内核打交道的桥梁，通过它我们可以使用UEFI提供的各种服务，如Boot Services和 Runtime Services。 SystemTable是UEFI内核中的一个全局结构体。
5。输出是通过EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL的OutputString服务完成的。服务(函数)的第一个参数是This指针，指向Protocol本身。 OutputString()的第二个参数是Unicode字符串。
要想编译main.c，我们还需要.inf文件, 在main.c所在的目录下编辑main.inf文件

##

[Defines]
  INF_VERSION                    = 0x00010005
  BASE_NAME                      = main #输出文件的名字为 main.efi
  FILE_GUID = 6987936E-ED34-ffdb-AE97-1FA5E4ED2117
  MODULE_TYPE   = UEFI_APPLICATION #模块类型：

UEFI_DRIVER

DXE_DRIVER

DXE_RUNTIME_DRIVER

UEFI_APPLICATION

,BASE,等
  VERSION_STRING   = 1.0
  ENTRY_POINT                    = UefiMain #入口函数

#
# The following information is for reference only and not required by the build tools.
#
#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC
#

# 源文件
[Sources]
   main.c

# .dec里面定义 include的路径
[Packages]
  MdePkg/MdePkg.dec

#要链接的库
[LibraryClasses]
  UefiApplicationEntryPoint
  UefiLib

[Protocols]
[FeaturePcd]
[Pcd.common]
[Guids]

#编译选项， = 表示选项附加到默认选项后面。 == 表示仅使用所定义的选项，弃用默认选项。
[BuildOptions]
  #MSFT:*_*_*_CC_FLAGS ==  /nologo /c /WX /GS- /W4 /Gs32768 /D UNICODE /O1ib2 /GL  /EHs-c- /GR- /GF /Gy /Zi /Gm /D EFI_SPECIFICATION_VERSION=0x0002000A /D TIANO_RELEASE_VERSION=0x00080006 /FAs /Oi-
  #MSFT:*_*_*_CC_FLAGS =   /wd4804
  #MSFT:Debug_*_IA32_CC_FLAGS =
  #MSFT:Debug_*_X64_CC_FLAGS =
  #MSFT:Release_*_IA32_CC_FLAGS =
  #MSFT:Release_*_IA32_CC_FLAGS =
  #MSFT:Release_*_IA32_DLINK_FLAGS =
  #GCC:Release_*_IA32_CC_FLAGS =

然后将 main.inf 添加到 Nt32Pkg.dsc 或UnixPkg.dsc 的[Components]部分，例如添加下面一行(example目录在EDK2下)

example/main/main.inf

然后就可以使用BaseTools下的build进行编译了。

Windows下执行
edksetup.bat
build -p Nt32Pkg\t32Pkg.dsc -a IA32

Linux 执行
source ./edksetup.sh BaseTools
build -p UnixPkg/UnixPkg.dsc -a IA32

其他类型的inf文件
(1) 可以看出标准的application处理命令行参数不方便，UEFI提供了帮我们处理命令行参数的入口函数ShellCEntryLib。我们要实现INTN ShellAppMain(UINTN Argc, CHAR16** Argv) 作为（开发者视角的）入口函数。

/*Main.c */
#include <Uefi.h>
INTN
EFIAPI
ShellAppMain (
  IN UINTN Argc,
  IN CHAR16 **Argv
  )
{
gST -> ConOut-> OutputString(gST -> ConOut, L"HelloWorld\n");
  return 0;
}

inf文件。我们需要连接ShellCEntryLib 库。

[Defines]
  INF_VERSION                    = 0x00010006
  BASE_NAME                      = Main
  FILE_GUID                        = 4ea97c46-7491-4dfd-b442-747010f3ce5f
  MODULE_TYPE                   = UEFI_APPLICATION
  VERSION_STRING               = 0.1
  ENTRY_POINT                    = ShellCEntryLib

#
#  VALID_ARCHITECTURES           = IA32 X64 IPF
#

[Sources]
  Main.c

[Packages]
  MdePkg/MdePkg.dec
  ShellPkg/ShellPkg.dec

[LibraryClasses]
  ShellCEntryLib
  UefiLib

[BuildOptions]

（2）使用main函数的application。如果你想像C一样使用main函数，那么你需要用到LibC。 LibC 中提供了ShellAppMain函数，我们要提供 int main(int Argc, char** Argv) 供其调用。

/*Main.c */
#include <Uefi.h>

int
EFIAPI
main (
  IN int Argc,
  IN char **Argv
  )
{

gST -> ConOut-> OutputString(gST -> ConOut, L"HelloWorld\n");

return 0;
}

真正的入口函数是 ShellCEntryLib，调用过程为 ShellCEntryLib -> ShellAppMain -> main.
inf 文件：我们需要连接 ShellCEntryLib 和LibC库。

[Defines]
  INF_VERSION                    = 0x00010006
  BASE_NAME                      = Main
  FILE_GUID = 4ea97c46-7491-4dfd-b442-747010f3ce5f
  MODULE_TYPE   = UEFI_APPLICATION
  VERSION_STRING   = 0.1
  ENTRY_POINT                    = ShellCEntryLib

#
#  VALID_ARCHITECTURES           = IA32 X64 IPF
#

[Sources]
  Main.c

[Packages]
  MdePkg/MdePkg.dec
  ShellPkg/ShellPkg.dec

[LibraryClasses]
LibC
ShellCEntryLib

UefiLib

[BuildOptions]
MSFT:*_*_IA32_CC_FLAGS = /Oi-

还要再说明一点，如果你的程序中用到了printf(...)等等标准C的库函数，那么一定要使用此种类型的application。因为 ShellCEntryLib 函数中会调用ShellAppMain(...), StdLib的ShellAppMain(...) 会对stdlib 进行初始化。然后才可以调用stdlib的函数。 (当然，如果你已经清楚地了解了入口函数的处理流程，你也可以手工调用StdLib的ShellAppMain进行出事后).
（3）Lib 模块的inf文件。开发大型工程的时候我们会用到lib，例如我们要开发视频解码程序，会用到zlib库，

[Defines]
  INF_VERSION                    = 0x00010005
  BASE_NAME                      = zlib
  FILE_GUID = 348aaa62-BFBD-4882-9ECE-C80BBbbbb736
  VERSION_STRING   = 1.0
  MODULE_TYPE   = BASE #Base 表示此模块编译为library
  LIBRARY_CLASS   = zlib

#
# The following information is for reference only and not required by the build tools.
#
#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC
#

[Sources]
  adler32.c
  crc32.c
  deflate.c
  infback.c
  inffast.c
  inflate.c
  inftrees.c
  trees.c
  zutil.c
  compress.c
  uncompr.c
  gzclose.c
  gzlib.c
  gzread.c
  gzwrite.c

[Packages]
  MdePkg/MdePkg.dec
  MdeModulePkg/MdeModulePkg.dec
  StdLib/StdLib.dec

[LibraryClasses]
  MemoryAllocationLib
  BaseLib
  UefiBootServicesTableLib
  BaseMemoryLib
  UefiLib
  UefiRuntimeServicesTableLib

[Protocols]

[FeaturePcd]

[Pcd]

[Guids]

[BuildOptions]
   GCC:*_*_IA32_CC_FLAGS = -D__UEFI__ -DLARGEFILE64_SOURCE=1  -w

然后将

zlib|zlib-1.2.6/zlib.inf # zlib-1.2.6 在EKD2的根目录下

放到.dsc 文件 [LibraryClasses]中。需要链接zlib的时候，在.inf文件的

[LibraryClasses]

中添加 zlib即可。
（4）driver模块的inf文件。例如DiskIo的inf(

MdeModulePkg/Universal/Disk/DiskIoDxe/DiskIoDxe.inf

)

[Defines]
  INF_VERSION                    = 0x00010005
  BASE_NAME                      = DiskIoDxe
  FILE_GUID = 6B38F7B4-AD98-40e9-9093-ACA2B5A253C4
  MODULE_TYPE   = UEFI_DRIVER
  VERSION_STRING   = 1.0
  ENTRY_POINT                    = InitializeDiskIo

#
# The following information is for reference only and not required by the build tools.
#
#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC
#
#  DRIVER_BINDING                =  gDiskIoDriverBinding
#  COMPONENT_NAME                =  gDiskIoComponentName
#  COMPONENT_NAME2               =  gDiskIoComponentName2
#

[Sources]
  ComponentName.c
  DiskIo.h
  DiskIo.c

[Packages]
  MdePkg/MdePkg.dec

[LibraryClasses]
  UefiBootServicesTableLib
  MemoryAllocationLib
  BaseMemoryLib
  BaseLib
  UefiLib
  UefiDriverEntryPoint
  DebugLib

[Protocols]
  gEfiDiskIoProtocolGuid                        ## BY_START
  gEfiBlockIoProtocolGuid                       ## TO_START