IT数码 购物 网址 头条 软件 日历 阅读 图书馆
TxT小说阅读器
↓语音阅读,小说下载,古典文学↓
图片批量下载器
↓批量下载图片,美女图库↓
图片自动播放器
↓图片自动播放器↓
一键清除垃圾
↓轻轻一点,清除系统垃圾↓
开发: C++知识库 Java知识库 JavaScript Python PHP知识库 人工智能 区块链 大数据 移动开发 嵌入式 开发工具 数据结构与算法 开发测试 游戏开发 网络协议 系统运维
教程: HTML教程 CSS教程 JavaScript教程 Go语言教程 JQuery教程 VUE教程 VUE3教程 Bootstrap教程 SQL数据库教程 C语言教程 C++教程 Java教程 Python教程 Python3教程 C#教程
数码: 电脑 笔记本 显卡 显示器 固态硬盘 硬盘 耳机 手机 iphone vivo oppo 小米 华为 单反 装机 图拉丁
 
   -> 开发工具 -> EDK环境搭建&UEFI工程模块文件介绍 -> 正文阅读

[开发工具]EDK环境搭建&UEFI工程模块文件介绍

一、UEFI开发环境配置

UEFI开发环境目前支持WindowsLinux,支持的平台也有很多如IntelAMDARM等。

下面主要是介绍如何在windows环境下进行EDK开发。

1.获取EDK源码

EDKII 源码的获取有很多途径

(1GitHub - tianocore/edk2: EDK II (建议用这个)

(2p/edk2/code - Revision 29574: /trunk/edk2

基本上以最新的为主,但是也要看一下最新的EDK sourcecode是否有什么问题。EDKRelease稳定的版本,像UDK2014UDK2015UDK2017UDK2018都是稳定的版本

2.搭建EDK运行环境,参考如下链接:

https://github.com/tianocore/tianocore.github.io/wiki/UDK2018-How-to-Build#how-to-build-windows-system

3.?编译EDK模拟器?

二、UEFI开发环境配置

1.获取EDK源码

?2.搭建EDK运行环境

? ? ? a)安装VS2015

注意需要安装ARM64(包含在C++组件中),否则会报错:

?

NMAKE : fatal error U1077: '"C:\Program Files (x86)\Microsoft Visual Studio14.0\Vc\Bin\cl.exe...“

C:\Program"不是内部或外部命令,也不是可运行的程序

??????? b)安装NASM(nasm-2.15.05-installer-x64.exe)

????????????? 默认安装路径为C:\Program Files\NASM

??????? c) 安装python2.7(python-2.7.18.amd64.msi)

? ? ? ? ? ??

???????????? 注意在安装界面选择将 Python 加入 Path

??????? d) 准备Win32 BaseTool

? ? ? ? ? ? ?https://github.com/tianocore/edk2-BaseTools-win32.git

? ? ? ? ? ? ?解压之后放在 BaseTools\Bin\Win32目录下。

? ? ? ? ? ? ?

3.编译EDK模拟器(Nt32Pkg)

??? a)打开命令行窗口,进入EDK代码目录,执行edksetup.bat --nt32,用于配置Nt32Pkg编译所需的环境。

?????? 类似于虚拟机,可以在这个窗口下调试纯软件的程序,如果程序涉及硬件,这个是没有用的。

???????运行后在conf下面生成三个配置文件:build_ruletargettools_def

???????这三个文件主要是用来配置编译环境和设定编译规则,在生成以后,根据自己的PC来设定编译使用的tool。一般我们只需要设定

?? ? ? ?target.txt这个文件即可为了后面编译的时候,不需要每次都指定编译使用的VS版本,target.txt里先指定为VS2015x86如下所示。

TARGET_ARCH = IA32表示编译的为32位程序X64表示编译的32程序,还有的架构包括ARM

TOOL_CHAIN_TAG = VS2015x86表示在64位的Windows上编译程序,VS2015表示在32位的Windows编译程序其它的可以不用修改。

?b)执行edksetup.bat --nt32和配置好target.txt文件后,命令行窗口直接输入build命令即可。

c) build完成以后,直接输入命令build run,即可运行EDK模拟器。

???? 至此Windows UEFI开发环境配置(模拟器版本)基本上结束了

搭建过程可能遇到的一些编译问题:

1.NMAKE : fatal error U1077: '"C:\Program Files (x86)\Microsoft Visual Studio14.0\Vc\Bin\cl.exe...“

? ??C:\Program"不是内部或外部命令,也不是可运行的程序

??? 解决方法:如前所述,VS安装时,选择安装ARM64(包含在C++组件中

2. ‘nasm’ is not recognized as an internal or external command, operable program or batch file

???? 解决方法:添加nasm安装路径到环境变量。

?????便捷方式? --? edksetup.bat中添加 path C:\Program Files\NASM;%path%

3.File GenFds\GenFds.py”, line 24, in <module> ValueError: Attempted relative import in non-package

?? 解决方将路径BaseTools\Bin\Win32GenFds.exe更名为GenFds.LABZ,并将BaseTools\BinWrappers\WindowsLike;添加到Path路径

? ? ? ?在edksetup.bat中添加 path BaseTools\BinWrappers\WindowsLike;%path%

4. ‘python.exe’ is not recognized as an internal or external command, operable program or batch file

???? 解决方法:设置PYTHON_HOME环境变量

??????便捷方式? -- --? edksetup.bat中添加 set PYTHON_HOME=C:\Python27

注:

1、在build的过程中,可能会有一些提示报错,要善于分析报错原因并解决问题。

2EDK build命令还有很多,如果只输入build,是按照Target.txt的默认配置来的,同时也可以指定build某个package,也可以指定tool,也可以指定生成多少位程序。

如:build -p [PlatformFile] -a [Architecture] -t [ToolChain]

?三、工程模块概要

? ? ? ? 在代码的根目录下,有许多以*Pkg命名的文件夹,每一个这样的文件夹可以称之为一个package。但准确的说,Package是一组模块(Module)和平台描述文件(.dsc文件)、包声明文件(.dec文件)组成的集合。

? ? ? ? 在Windows下使用VS(Visual Studio)时,通常要建立工程文件和源文件。类似的,在EDK2环境下,我们除了编写源文件外,还要为工程编写元数据文件(.inf文件).inf文件与VS的工程文件功能类似,用于自动编译源代码。

? ? ? ? ?包相当于VS中的项目,.dsc文件则相当于VS项目的.sln文件;模块相当于VS项目中的工程,.inf则相对于VS工程的.proj文件。

? ? ? ? ?EDK2中主要的模块类型如下:、

模块类型

说明

标准应用程序工程模块

DXE阶段运行的应用程序(Shell环境下也可以运行)

ShellAppMain应用程序工程模块

Shell环境下运行的应用程序

Main应用程序工程模块

Shell环境下运行的应用程序,并且应用程序链接了StdLib

UEFI驱动模块

符合UEFI驱动模型的驱动,仅在BS期间有效

库模块

作为静态库被其他模块调用

DXE 驱动模块

DXE环境下运行的驱动,此类驱动不遵循UEFI驱动模型

DXE运行时驱动模块

进入运行期仍然有效的驱动

DXE SAL驱动模块

仅对安腾CPU有效的一种驱动

DXE SMM驱动模块

系统管理模式驱动,模块被加载到系统管理内存区。系统进入运行期改驱动仍然有效

PEIM模块

PEI阶段的模块

SEC模块/PEI_CORE模块/DXE_CORE模块

固件的SEC阶段/固件的PEI阶段/固件的DXE阶段

四、标准应用程序工程模块

? ? ? 标准应用程序工程模块是其他应用程序工程模块的基础,也是UEFI中常见的一种应用程序工程模块。

??????? 每个工程模块由两个部分组成:工程文件和源文件。源文件包括C/C++文件、 .asm汇编文件,也可以包括.uni(字符串资源文件).vfr(窗体资源文件)等资源文件。

? ? ? ? 下面是一个简单的应用程序工程模块的组成:

?

五、标准应用程序工程模块--源文件

? ? ? ?源文件UefiMain.c:仅有一个函数UefiMainUefiMain是这个模块的入口函数,其功能是向标准输出设备输出字符串。

关于入口函数:

???? 1.UEFI标准应用程序的入口函数通常是UefiMain,也可以工厂文件.inf中定义新的入口函数

???? 2.入口函数的函数名可以变化,但其函数原型(返回值类型和参数列表类型)不能变化。

六、标准应用程序工程模块--工程文件

? ? ? ?在UefiMain这个例子中,还有一个UefiMain.inf的文件。这个文件是工程文件,用于指导EDK2编译工具自动编译模块。.inf(Module Information File)文件就相当于Makefile文件或者Visual Studio.proj文件。

? ? ? ? 工程文件分为很多个块,每个块以”[块名]”开头,”[块名]”必须单独占一行。有些块名是所有工程都必须的块,这些块包括[Defines][Sources][Packages][LibraryClasses]。其他的块并不是每个模块都一定要编写的块,仅在用到的时候需要编写这些块。

? ? ? 工程文件必须块如下:

必须块

块描述

[Defines]

定义本模块的属性变量及其他变量,这些变量可在工程文件其他块中引用

[Sources]

列出本模块的所有源文件及资源文件

[Packages]

列出本模块应用到的所有包的包声明文件。可能引用到的资源包括头文件、GUIDProtocol等,这些资源都声明在包的包声明文件.dec

[LibraryClasses]

列出本模块要链接的库模块

? ? ??工程文件非必须块如下:

非必须块

块描述

[Protocols]

列出本模块用到的Protocol

[Guids]

列出本模块用到的GUID

[BuildOptions]

指定编译和链接选项

[Pcd]

列出本模块用到的Pcd变量

[PcdEx]

列出本模块用到的Pcd变量

[FixedPcd]

列出本模块用到的Pcd编译期变量

[FeaturePcd]

列出本模块用到的Pcd变量

[PatchPcd]

列出的Pcd变量仅本模块

?

INF_VERSION??????? INF标准的版本号。EDK2build会检查INF_VERSION的值并根据这个值解析.inf文件。

BASE_NAME???????? : 模块名字字符串,不能包含空格。通常也是输出文件的名字。

FILE_GUID???????????? : 每个工程文件必须有一个8-4-4-4-12格式的GUID,用于生成固件。

VERSION_STRING :模块的版本号字符串。

MOUDLE_TYPE???? :定义模块的模块类型。可以是SEC/PEI_CORE/PEIM/DXE_CORE/DXE_SAL_DRIVER/DXE_SMM_DRIVER/UEFI_DRIVER/DXE_DRIVER/DXE_RUNTIME_DRIVER/UEFI_APPLICATION/BASE中的一个。

ENTRY_POINT?????? :定义模块的入口函数。

七、其他类型工程模块? ---Shell应用程序工程模块

? ? ? ?标准应用程序处理命令行参数很不方便,而能在Shell中执行的命令(命令也是应用程序)通常都会带有命令行参数,为了方面处理参数,EDK2提供一种以INTN ShellAppMain(IN UINTN ArgcIN CHAR16 **)作为入口函数的模块,即Shell应用程序工程模块。

?

? ? ? ? 因为在入口函数的参数中没有了SystemTable,所以要通过全局变量gST使用系统表。入口函数ShellAppMain的第一个参数Argc是命令行参数个数,第二个参数Argv是命令行参数列表。Argv列表中的每个参数都是Unicode字符串(CHAR16* 类型的字符串)

? ? ? ? 除了入口函数方面的差异,在工程文件(inf文件)中也存在差异:

?ENTRY_POINT必须为ShellCEntryLib,源程序中必须提供ShellAppMain

[Packages]块中,必须列出ShellPkg/ShellPkg.dec?

[LibraryClasses]块中,必须列出ShellCEntryLib?

在库模块的工程文件中,需要设置MODULE_TYPEBASE;设置LIBRARY_CLASSlibrary的名字。同时不要设置ENTRY_POINT。

有些库仅能被某些特定的模块调用时,需要在工程文件中声明库的使用范围,声明方法是在[Defines]块的LIBRARY_CLASS变量中定义,格式如下:

? LIBRARY_CLASS = 库名字? | 适用模块类型1 适用模块类型2

?编写了库之后,要使库能被其他模块调用,还要在包的.dsc文件中声明该库。

如果库使用前需要进行初始化,在库的工程文件需指定CONSTRUCTORDESTRUCTOR CONSTRUCTOR会在ENTRY_POINT之前执行, DESTRUCTOR会在ENTRY_POINT之后执行。

八、其他类型工程模块? ---UEFI 驱动模块

? ? ? ?在UEFI中,驱动分为两类:一类是符合UEFI 驱动模型的驱动,模块类型为UEFI_DRIVER,称为UEFI驱动,另一类是不遵循UEFI驱动模型的驱动,模块类型包括DXE_DRIVERDXE_SAL_DRIVERDXE_SMM_DRIVER、DXE_RUNTIME_DRIVER,称为DXE驱动。

? ? ? ?驱动与应用程序的模块入口函数(ENTRY_POINT)类型一样。函数原型如下:

? ? ?工程模块方面的差异主要为:

??? 1.[Defines]块中,MODULE_TYPE设置为UEFI_DRIVER

??? 2.[Sources]块中,通常包含有ComponentName.c,此文件定义了驱动的名字,驱动安装后,名字将显示给用户。

??? 3.[LibraryClasses]块中,必须包含UefiDriverEntryPoint

九、包及dsc/dec/fdf文件? ---概要

? ? ? ?每个Package()包含一个.dec(Package Declaration File)文件、一个.dsc(Platform Description File)文件。如果一个包还要生成固件ImageOption Rom Image,这个包还要包含.fdf(Flash Description Files)

??????? 下面是这些文件如何整合成一个Image的过程:

Build命令用于编译包,它需要一个.dsc文件、一个.dec文件以及一个或多个.inf文件。

GenFW命令用于制作固件或Option RomImage,它需要一个.dec文件和一个.fdf文件。

十、包及dsc/dec/fdf文件? ---dsc文件

? ? ???.inf用于编译一个模块,而.dsc文件用于编译个一个Package,它包含[Defines][LibraryCalsses][Components]几个必须部分以及[PCD][BuildOptions]等几个可选部分。

[Defines]

????? 用于设置Build相关的全局宏变量,这些变量可以被.dsc文件的其他模块引用。必须是.dsc文件的第一个部分。通过DEFINEEDK_GLOBAL定义的宏可以在.dsc文件和.fdf文件中通过$(宏变量名)使用。

[LibraryClasses]

????? 定义库的名字以及库.inf文件的路径。这些库可以被[Components]块内的模块引用。

[Components]

????? 在该区域内定义的模式都会被build工具编译并生成.efi文件

[PCD]

????? 用于定义平台配置数据。其目的是在不改动.inf文件和源文件的情况下完成对平台的配置。

十一、包及dsc/dec/fdf文件? ---dec文件

? ? ? ? ? .dec文件定义了公开的数据和接口,供其他模块使用。它包含了必须区块[Defines]以及可选区块[Includes][Guids]、[LibraryClasses][Protocols][Ppis][PCD]几个部分。

[Defines]

????? 提供package的名称、GUID、版本号等信息

[Includes]

????? 列出本Package提供的头文件所在的目录。路径起始于本Package.dsc所在的目录。

[LibraryClasses]

????? Package可以通过.dec文件对外提供库,每个库都必须有一个头文件。本区块用于明确库和头文件的对应关系。

[Guids]

????? 用于定义工程文件(inf)[Guids]使用到的GUID

[Protocols]

????? [Guids]块相同,用于是Protocol GUID定义的地方。

十二、包及dsc/dec/fdf文件? ---fdf文件

? ? ? ? ??fdfFlash Description File)用于生成固件映像,定义Image的内容和布局信息,它由[Defines][FD][FV][Rule]等几个部分组成

常用缩写

FD:固件设备,指任何可以存储固件的设备或设备集合

FV:固件卷,指在FD上一个连续的部分,可以看成是一个逻辑设备,经常提到的FFS概念也是以FV的形式存在,它描述了FV中的文件组织形式;FF:固件文件,指在FV上组织代码和数据的一个集合

FFSFV上的文件实际上是以FFS的形式保存在FV

FDF:描述整个FD,以及各个FV,我们想了解FD中都有哪些FV,只要查看FDF文件即可

? ? ? ? ? ?fdfFlash Description File)用于生成固件映像,定义Image的内容和布局信息,主要使用到[Defines][FD][FV]这几个部分组成

[Define]

? 这部分Section是可选的,里面放置到的东西一般用来放宏定义和变量

[FD]

???? 1.FDF文件里面可以有多个FD

???? 2.[FD]包含几个有特殊意义的变量,如下:

??????????? BaseAddress:表示FD的基址,它是设备开机之后BIOS被加载到系统中的位置

??????????? Size:表示FD的大小,单位是字节

??????????? ErasePolarity:表示的是用1还是0Flash,目前基本上都是1

??????????? BlockSize:表示Flash中一个Block的大小,一般就是4K64K

??????????? NumBlocks:表示FlashBlock的个数,通常就是Size除以BlockSize

???? 3. [FD]中另外包含的一个重要的内容是FD布局,描述结构如下,该定义在FD中开辟了一段空间,用来放置某些

???????? 内容,比如FV之类的。

? ? ? ? ?OffsetSize是这段空间的对于整个FD的偏移和大小,Pcd是可选的,其实就是初始化了PCD来表示这段空间偏移和大小供后续使用,并不是必须的,它可以FDF文件的各处使用;RegionType表示这段空间的类型,可以是FVDATAFILE

[FV]

???? 定义FV中具体包含什么模块文件。

???? FV是可以嵌套

???? [FV]的最开始是几个TOKEN,代表一些属性设定

???? [FV]中也可以使用DEFINESET来定义宏和变量

???? [FV] Section中使用INF语句来指定FV中包含什么文件

???? [FV]中可以直接包含文件,使用的是FILE语句

?

?

?

?

?

  开发工具 最新文章
Postman接口测试之Mock快速入门
ASCII码空格替换查表_最全ASCII码对照表0-2
如何使用 ssh 建立 socks 代理
Typora配合PicGo阿里云图床配置
SoapUI、Jmeter、Postman三种接口测试工具的
github用相对路径显示图片_GitHub 中 readm
Windows编译g2o及其g2o viewer
解决jupyter notebook无法连接/ jupyter连接
Git恢复到之前版本
VScode常用快捷键
上一篇文章      下一篇文章      查看所有文章
加:2022-01-29 23:17:35  更:2022-01-29 23:18:28 
 
开发: C++知识库 Java知识库 JavaScript Python PHP知识库 人工智能 区块链 大数据 移动开发 嵌入式 开发工具 数据结构与算法 开发测试 游戏开发 网络协议 系统运维
教程: HTML教程 CSS教程 JavaScript教程 Go语言教程 JQuery教程 VUE教程 VUE3教程 Bootstrap教程 SQL数据库教程 C语言教程 C++教程 Java教程 Python教程 Python3教程 C#教程
数码: 电脑 笔记本 显卡 显示器 固态硬盘 硬盘 耳机 手机 iphone vivo oppo 小米 华为 单反 装机 图拉丁

360图书馆 购物 三丰科技 阅读网 日历 万年历 2024年11日历 -2024/11/15 10:28:09-

图片自动播放器
↓图片自动播放器↓
TxT小说阅读器
↓语音阅读,小说下载,古典文学↓
一键清除垃圾
↓轻轻一点,清除系统垃圾↓
图片批量下载器
↓批量下载图片,美女图库↓
  网站联系: qq:121756557 email:121756557@qq.com  IT数码