BIOS知识枝桠—— Library

最新推荐文章于 2023-10-12 23:32:02 发布
最新推荐文章于 2023-10-12 23:32:02 发布
阅读量2k 收藏 15
点赞数 4
分类专栏： BIOS 文章标签： bios
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_45279063/article/details/115324601
版权

Library overview

Lib Overview

Library即通常所说的库, 是一个二进制文件, 一般包含了很多函数的实现和对应的数据在里面, 以供其他人使用
库中所列的一系列函数即库函数, 库函数可供本Package也可跨Package使用, 比较灵活。

Lib的作用：将常用的功能写成函数, 方便他人调用, 无需重复”造轮子”；可以以二进制 (.lib)格式来release, 不需要提供源代码

Lib的文件结构

库一般由三个部分组成：实体、头文件、Dec文件
在这里插入图片描述

库的实体：

实体一般由.inf和.c构成，路径：
%WORKSPACE%\xxxPkg\Library\yyyLib\zzz\zzzz.c
xxx: Package name, for example: Mde, MdeModule等
yyy: Library name, for example: Cmos, Debug, Hob等
zzz: Library 子文件夹，可选
zzzz: 库函数所在C文件名
例如:WhiskeyLake\MdePkg\Library\BaseLib\BaseLib.inf

[Defines]
  INF_VERSION                    = 0x00010005
  BASE_NAME                      = BaseLib
  MODULE_UNI_FILE                = BaseLib.uni
  FILE_GUID                      = 27d67720-ea68-48ae-93da-a3a074c90e30
  MODULE_TYPE                    = BASE
  VERSION_STRING                 = 1.1
  LIBRARY_CLASS                  = BaseLib

含有LIBRARY_CLASS属性, 就是一个库因为它的MODULE_TYPE是BASE类型, 所以可以在任何情况下被使用, 如果非BASE类型, 则还需要在BaseLib后面跟上它可被使用的场景,。
例如：
LIBRARY_CLASS = HobLib|DXE_DRIVER
DXE_RUNTIME_DRIVER DXE_SAL_DRIVER SMM_CORE
DXE_SMM_DRIVER UEFI_APPLICATION

库的头文件：

库函数在头文件中被声明，被调用者Include，这样调用者才能知道库中有哪些函数以及各自具体用法头文件路径如下：
%WORKSPACE%\xxxPkg\Include\Library\yyyLib.h
例如:WhiskeyLake\MdePkg\Include\Library\BaseLib.h

库的Dec文件：

Dec文件：将头文件和库名连接起来
MdePkg.dec
–[LibraryClasses]
----BaseLib|Include/Library/BaseLib.h

库函数的调用：

以BaseLib为例：: MdePkg\Library\BaseLib
1：调用者的.inf要包Library所在的Package的dec文件
[Packages]
MdePkg/MdePkg.dec

2：调用者的.inf要包Library name
[LibraryClasses]
BaseLib
在这里插入图片描述
3： 调用者的.c中要包Library对应的头文件
#include <Library/BaseLib.h>

4：调用者的.c中使用库函数

MdePkg 常用Lib

PUBLIC DEFINITIONS

  • PI: Common definitions in PI spec
  • Uefi: Common definitions in UEFI spec
  • Guid: Guid defined in PI/UEFI for Variable/Hob/EventGroup/SystemTable
  • Ppi: PPI defined in PI spec
  • Protocol: Protocol defined in PI/UEFI spec
  • IndustryStandard
    • Acpi
    • Pci
    • Tpm
    • Sdram
  • Register
    • Intel: CPU related registers
    • Amd: CPU related registers

BaseLib

String APIs：进行string相关操作，strncpy …

  • List APIs:insert remove found ,InsertHeadList、GetFirstNode等
  • Math APIs:乘除，左右移，找高低位，HighBitSet32，DivU64x32…
  • BitField APIs:操作寄存器，比如32位取哪几位进行与或操作，BitFieldOr64、CaluateSum等
  • CPU APIs:CPU pause ,EnableInterrupts , …
  • Register Read/Write APIs:大多汇编code，进行常用寄存器的读写Cr0、Dr0、CS 、DS 、Gdtr ,AsmReadCr0…

BASEMEMORYLIB

  • CopyMem
  • SetMem
  • ZeroMem
  • CompareMem
  • ScanMem
  • CopyGuid/ScanGuid/CompareGuid/IsZeroGuid:专门添加的API，用于对编写过程中的Guid进行操作

DEBUGLIB

  • gEfiMdePkgTokenSpaceGuid.PcdDebugPropertyMask：该PCD通过不同的位控制着Lib中下面函数的可执行情况，当全部置零，将不产生任何打印信息
  • ASSERT()：当条件不成立时候停止
  • DEBUG()：添加打印信息的类型以及打印内容
  • ASSERT_EFI_ERROR()
  • DEBUG_CODE_BEGIN()/DEBUG_CODE_END()：写一段逻辑运行与打印初期或者结束时候
  • DEBUG_CLEAR_MEMORY()：将某一段空间清空

REPORTSTATUSCODELIB

  • gEfiMdePkgTokenSpaceGuid.PcdReportStatusCodePropertyMask：控制report的类型，除非产品有要求
  • REPORT_STATUS_CODE
  • REPORT_STATUS_CODE_WITH_DEVICE_PATH
  • REPORT_STATUS_CODE_WITH_EXTENDED_DATA
  • REPORT_STATUS_CODE_EX

HOBLIB

Hob在PEI Phase 或者说在Memory Ready之前等价于Memory,在只有CAR的阶段需要轻量级的方式管理信息，设计出了HOB，HOB管理方式为从上到下，逐渐叠加

  • GetHobList
  • GetFirstHob/GetNextHob
  • GetFirstGuidHob/GetNextGuidHob
  • GET_HOB_TYPE()/GET_HOB_LENGTH()/GET_NEXT_HOB()
  • GET_GUID_HOB_DATA()/GET_GUID_HOB_DATA_SIZE()
  • BuildGuidHob/BuildGuidDataHob
  • BuildFvHob
  • BuildResourceDescriptorHob/BuildMemoryAllocationHob

MEMORYALLOCATIONLIB

  • AllocatePages\AllocateAlignedPages
  • FreePages\FreeAlignedPages
  • AllocatePool
  • AllocateZeroPool
  • AllocateCopyPool
  • ReallocatePool
  • FreePool

PCDLIB

  • PcdGetXX/PcdSetXX: Boolean, UINT8, UINT16, UINT32, UINT64, and VOID*
  • FixedPcdGetXX
  • PatchPcdGetXX
  • PcdGetSize: VOID* PCD type only
  • LibPcdGetSku/LibPcdSetSku: Dynamic PCD only
  • LibPcdCallbackOnSet/LibPcdCancelCallback: Dynamic PCD only

IOLIB

  • IO_LIB_ADDRESS
  • IoReadXX/IoWriteXX
  • IoOrXX/IoAndXX/IoAndThenOrXX
  • IoBitFieldXX
  • MmioReadXX/MmioWriteXX
  • MmioOrXX/MmioAndXX/MmioAndThenOrXX
  • MmioBitFieldXX
  • MmioReadBufferXX/MmioWriteBufferXX

PCILIB

  • PCI_LIB_ADDRESS
  • PciReadXX/PciWriteXX
  • PciOrXX/PciAndXX/PciAndThenOrXX
  • PciBitFieldXX
  • PciReadBuffer/PciWriteBuffer

PEISERVICESTABLEPOINTERLIB

• GetPeiServicesTablePointer()/SetPeiServicesTablePointer()

UEFIBOOTSERVICESTABLELIB

  • gST
  • gBS
  • gImageHandle

DXESERVICESTABLELIB

• gDS

UEFIRUNTIMESERVICESTABLELIB

gRT

SMMSERVICESTABLELIB

  • gSmst
  • InSmm()

PEIMENTRYPOINT/ UEFIDRIVERENTRYPOINT/UEFIAPPLICATIONENTRYPOINT

  • _ModuleEntryPoint
  • ProcessLibraryConstructorList
  • ProcessModuleEntryPointList
  • _DriverUnloadHandler
  • ProcessModuleUnloadList
  • ProcessLibraryDestructorList
    在AutoGen code才会体现出来，在.c不需要使用

常用函数汇总表

库函数作用对应的库名对应的 package对应的头文件
IO相关
IoRead8操作IO, 读8位数据IoLibMdePkg.decMdePkg\Include\Library\IoLib.h
IoWrite8操作IO, 写位数据IoLibMdePkg.decMdePkg\Include\Library\IoLib.h
MmioRead8读内存方式获取MMIO 8位数据IoLibMdePkg.decMdePkg\Include\Library\IoLib.h
MmioWrite8写内存方式往MMIO写8位数据IoLibMdePkg.decMdePkg\Include\Library\IoLib.h
String相关
StrCpyCopy stringBaseLibMdePkg.decMdePkg\Include\Library\BaseLib.h
StrLen计算Unicode string长度,每个字符占两个字节大小BaseLibMdePkg.decMdePkg\Include\Library\BaseLib.h
StrSize计算所有字符个数，每个字符占位一个字节BaseLibMdePkg.decMdePkg\Include\Library\BaseLib.h
StrCmp比较两个字串是否相同BaseLibMdePkg.decMdePkg\Include\Library\BaseLib.h
StrHexToUintn取出字符串中0x开头的十六进制数BaseLibMdePkg.decMdePkg\Include\Library\BaseLib.h
Debug相关——————————
Print打印Unicode string到ConOut设备（屏幕/串口）UefiLibMdePkg.decMdePkg\Include\Library\UefiLib.h
AsciiPrint打印Unicode string到ConOut设备（屏幕/串口）UefiLibMdePkg.decMdePkg\Include\Library\UefiLib.h
DEBUG创建EventBaseLibMdePkg.decMdePkg\Include\Library\BaseLib.h
ASSERT参数为0时系统Hang，并向ConsoleOut打印Error信息BaseLibMdePkg.decMdePkg\Include\Library\BaseLib.h
MicroSecondDelayDelay in Micro LevelCpuTimerLibMdePkg.decMdePkg\Include\Library\TimerLib.h
NanoSecondDelayDelay in Nano LevelCpuTimerLibMdePkg.decMdePkg\Include\Library\TimerLib.h
PCD相关
PcdGet8Get 8位PCD valuePcdLibMdePkg.decMdePkg\Include\LibraryPcdLib.h
PcdGet8Set 8位PCD valuePcdLibMdePkg.decMdePkg\Include\Library\PcdLib.h
HOB相关
GetHobList获取HobListPeiHobLibMdePkg.decMdePkg\Include\Library\HobLib.h
GetFirstGuidHob获取GUID HOB 类型首个HOBPeiHobLibMdePkg.decMdePkg\Include\Library\HobLib.h
GetNextGuidHob获取GUID HOB 类型下一个HOBPeiHobLibMdePkg.decMdePkg\Include\Library\HobLib.h
Memory相关
CopyMemCopies a source buffer to a destination bufferBaseMemoryLibMdePkg.decMdePkg\Include\Library\BaseMemoryLib.h
SetMem写内存BaseMemoryLibMdePkg.decMdePkg\Include\Library\BaseMemoryLib.h
ZeroMem一个buffer的内存全写0BaseMemoryLibMdePkg.decMdePkg\Include\Library\BaseMemoryLib.h
CompareMem比较两个buffer数据BaseMemoryLibMdePkg.decMdePkg\Include\Library\BaseMemoryLib.h
CompareGuid比较GUID是否相同BaseMemoryLibMdePkg.decMdePkg\Include\Library\BaseMemoryLib.h
Hi,Hubery
关注
  • 4
    点赞
  • 踩
  • 15
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
知识升华——bios设置图解
06-18
【BIOS设置图解】 BIOS（Basic Input/Output System）是计算机启动时加载的第一个软件，它是连接硬件和操作系统之间的桥梁。通过BIOS设置，我们可以调整计算机的基本硬件配置，优化系统性能，解决硬件兼容性问题，...
电脑必备知识——BIOS设置详解
07-04
BIOS，全称为Basic Input Output System，是计算机中不可或缺的基础程序，它被固化在主板上的ROM芯片...理解BIOS和CMOS的功能及相互关系，对于电脑用户来说是非常基础且重要的知识，有助于解决日常遇到的许多技术问题。
UEFI源码解析之HOB
wangadi057612的博客
02-05 2742
HOB全程Hand off Block，粗暴的理解就是握手时候传递的block；Pei阶段和Dxe阶段的握手，Block中的信息主要是内存等一些平台资源；PEI阶段把自己能获取到的平台相关信息通过block的方式传递给Dxe阶段
PEI编程练习 － hob简单练习
C学习
12-26 2995
1
【UEFI基础】HOB介绍
jiangwei0512的博客
03-11 2905
【UEFI基础】HOB介绍。
【UEFI实践】BIOS升级(1) --shell下升级BIOS
最新发布
Mutouyugi的博客
10-12 1102
BIOS升级会分为Shell，Setup，OS下三种情况说明。本文将会以shell下升级为主，具体操作为在shell下获取需要升级的BIOS文件信息，再把数据传给SMM模式下刷写Flash。与capsule的实现方法类似，但仅以最简单能够更新BIOS的方法。部分代码借鉴EDKII源码，如有侵权，请联系删除后续有更深理解，会继续补充。学艺不精，错误请指正；如有侵权，请联系删除。
EFI基本概念之HOB
zhao_longwei的专栏
02-01 8617
1 基本概念及用法     HOB是Hand-offblock的缩写。是PEI阶段向DXE传递系统信息的手段。PEI阶段构建一些HOB结构，然后将其作为参数传给DXE阶段函数，DXE Core会根据其使用平台相关资源。     HOB是系列的连续的内存结构体，可以认为其由三部分构成：第一部分，是PHIT头，它描述了HOB的起始地址以及总的内存使用；第二部分是各个Hob列表，DXE阶段会根据这一
Bios 基础知识
03-15
BIOS是英文"Basic Input Output System"的缩略语，直译过来后中文名称就是"基本输入输出系统"。其实，它是一组固化到计算机内主板上一个ROM芯片上的程序，它保存着计算机最重要的基本输入输出的程序、系统设置信息、...
BIOS全解和相关知识
03-24
"BIOS基础知识和设置详解" BIOS（Basic Input/Output System，基本输入/输出系统）是计算机最底层的操作系统，它负责管理计算机的硬件设备，并提供了基本的输入/输出功能。在本文中，我们将详细介绍BIOS的基础知识...
BIOS知识精解及问题释疑大全
12-21
BIOS知识精解及问题释疑大全
BIOS知识枝桠——PCD
这里是为我所统率的战场
06-11 4561
PCDPCD OverviewPCD TYPES PCD Overview PCD的主要目的就是把代码里面的可配置选项抽取出来，抽取出来的好处是倘若平台真的需要一些配置的时候，不需要修改源码，通过修改dsc把这些东西影响到，是最好的。这个PCD不止是要在编译过程中可以配置，还可以在运行时配置。 配置PCD有几种方式，目的是让platform时候更为容易进行定制化，减少effect 1：在build time时候，通过编译选项或者dsc的值进行设置从而影响源码； 2：在Boot过程中，通过某个Driver生成
BIOS知识枝桠——Device Path
这里是为我所统率的战场
08-11 4082
EFI Device Path定义&原型EFI Device Path种类Hardware Device PathMedia Device PathEnd of Hardware Device Path 定义&原型 Device Path: 一种为区分各种设备而命名的地址 Prototype: /** This protocol can be used on any device handle to obtain generic path/location information c
UiApp的生命周期
Anthony的博客
02-11 1865
当一台机器按某一个快捷键进setup界面的时候，如F2/F8/ESC，UiApp的生命周期就正式开始了。 UiApp，顾名思义，它就是一个app，只不过，这是一个特殊的app，我们进入setup的界面就是这个app的具体表现
UEFI原理与编程（五）：UEFI工程模块文件-库模块
kaliopensourcextu
04-27 6052
UEFI工程模块文件-库模块前言　　 在传统C/C++项目开发中经常会用到库，在UEFI大型工程项目开发中也是这样的。EDK2也提供库模块，来实现它。
BaseLibrary
未来很长，但我会努力的走下去。
01-14 4974
BaseLibrary 项目地址：MirkoWu/BaseLibrary  更多：作者   提 Bug    标签：   本库旨在开发项目时能快速搭建框架，提供较为常用的开发工具。建议下载作为依赖库， 便于修改。部分功能会仅在 demo 中有体现，请详细看完 demo。 下面介绍本库的主要内容 1. MVP 模式(变种) Model ：使用 Retrofit + OkHttp +...
lbaselib.c解析（5.3.4）
活在阳光下
09-04 799
/* ** $Id: lbaselib.c,v 1.314 2016/09/05 19:06:34 roberto Exp $ ** Basic library ** See Copyright Notice in lua.h */ #define lbaselib_c #define LUA_LIB #include "lprefix.h" #include #include #in
qemu逃逸小识
weixin_45209963的博客
10-15 1686
实际上，看过单片机datasheet的同学就会发现，单片机的数据读取/发送，命令执行等等都是受外加电平控制的，我们设想计算机将自己的总线分别接到单片机芯片上，就能明白为什么对地址空间读写就相当于操作外设。（简单来说就是，你写的exp里面mmap分的地址，只在exp程序内，或者说qemu虚拟出来的系统的用户态下有意义，对qemu-system下你自己写的其他程序来说是在同一个地址空间内，但仅此而已）qemu设备号的查看、地址的读取和地址空间的转换，上面两位师傅的blog里面已经写的很清晰了。
高通UEFI研究[二]
jlgcumt的博客
03-10 2436
1、库模块 （1）开发大型工程的时候经常会用到库，设置 MODULE_TYPE 为 BASE ；设置 LIBRARY_CLASS 为library 的名字。同时，不要设置 ENTRY_POINT。 [Packages] 块列出库引用到的包， [LibraryClasses] 列出包所依赖的其他库。 （2）有些库仅能被某些特定的模块调用，编写这种库时需在工程文件中声明库的适用范围，声明方法是在 [D...
DxeIPL
Helping BIOSer become Awesome!
08-01 2107
DxeIPL 简介 DXE IPL 是DXE Initial Program Loader 的简称。PI 规范规定PEI 阶段必须有一个Architecture PPI, 称 为DXE IPL PPI, PEI Foundation 通过DXE IPL PPI 向DXE 阶段交权。当PEI Foundation dispatch 完所有 的PEIM 后，调用DXE IPL PPI. DXE ...
服务器BIOS需要掌握哪些知识
02-28
掌握服务器BIOS需要以下知识： 1. 了解BIOS的基本功能和作用：BIOS是服务器的基础软件，掌握它的基本功能和作用是理解BIOS的基础。 2. 熟悉服务器硬件：BIOS设置往往涉及到服务器硬件的配置，因此，需要对服务器...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值