高通xbl创建protocol驱动 及 abl调用xbl中的驱动

已于 2024-02-05 09:57:05 修改
阅读量1.1k 收藏 23
点赞数 12
分类专栏： 高通xbl和abl 文章标签： linux c语言 arm开发
于 2024-02-05 09:39:01 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/hinewcc/article/details/135961843
版权

UEFI有关的文件格式介绍：

fdf：flash definitionfile，描述flash分区地址范围

dec：package declarationfile，定义了不同模块的GUID信息

dsc：description file，主要包含需要用到的所有inf文件

inf：单个模块的编译信息，类似makefile

efi ：最终编译生成的UEFI可执行文件

一、xbl创建 protocol 驱动

先看下创建一个 protocol 驱动改了哪些文件

boot_images/QcomPkg/Drivers/TestDxe 目录下创建2个文件：

TestDxe.inf        //定义驱动入口点和编译内容（类似于makefile）

TestDxe.c          //定义驱动内容

1、定义驱动入口

1.1 定义 QcomPkg/Drivers/TestDxe/TestDxe.inf 文件内容（类似于makefile）

加载驱动时会运行 ENTRY_POINT 入口函数

[Defines]
  INF_VERSION                    = 0x00010005	//平台UEFI Protocol版本号
  BASE_NAME                      = TestDxe		//UEFI Protocol 名
  FILE_GUID                      = 1e5605ad-daf5-41a8-8141-4fdb7ccbd032	//文件GUID, 可以上https://www.guidgen.com网站生成 
  MODULE_TYPE                    = UEFI_DRIVER
// 模块类型，分为DXE_DRIVER(UEFI驱动)、BASE（EDK库或PEI）、UEFI_APPLICATION(UEFI应用程序)三种
  VERSION_STRING                 = 1.0			//驱动自定义的版本号
  ENTRY_POINT                    = TestEntryPoint	//驱动入口函数，加载该驱动时会首先运行该函数

[Sources]			//驱动的C文件
  TestDxe.c

[Packages]			//本驱动包含的库的头文件
  ArmPkg/ArmPkg.dec
  MdePkg/MdePkg.dec
  MdeModulePkg/MdeModulePkg.dec
  QcomPkg/QcomPkg.dec

[LibraryClasses]	//本驱动中会使用到的库
  BaseLib
  DevicePathLib
  MemoryAllocationLib
  PrintLib
  UefiDriverEntryPoint
  UefiLib
  QcomLib

[Guids]
  gEfiUfsLU0Guid

[Protocols]			//本驱动中会使用到的驱动guid
  gEfiTestProtocolGuid

1.2 设置 TestDxe.inf 运行

创建好 TestDxe.inf 文件后，如果需要能够运行，则需要将 inf 添加进平台配置文件中：

  • 配置 boot_images/QcomPkg/SDMPkg/855/AU/Apriori.fdf.inc 文件
        INF QcomPkg/Drivers/DDRInfoDxe/DDRInfoDxe.inf
        INF QcomPkg/Drivers/ResetRuntimeDxe/ResetRuntimeDxe.inf		
        INF QcomPkg/Drivers/TestDxe/TestDxe.inf		#新增
  • 配置 boot_images/QcomPkg/SDMPkg/855/AU/Core.dsc 文件
  #
  # ShmBridgeDxe Driver
  #
  QcomPkg/Drivers/ShmBridgeDxe/ShmBridgeDxeLA.inf


  QcomPkg/Drivers/TestDxe/TestDxe.inf				#新增
  • 配置 boot_images/QcomPkg/SDMPkg/855/AU/Core.fdf 文件
  INF QcomPkg/Drivers/UsbConfigDxe/UsbConfigDxe.inf
  INF QcomPkg/Drivers/TestDxe/TestDxe.inf			#新增

2、创建驱动的 GUID

  • 在线生成GUID，https://www.guidgen.com，界面如下：

​​​​​​​

  • 设置 boot_images/QcomPkg/QcomPkg.dec
[Defines]
  DEC_SPECIFICATION              = 0x00010005
  PACKAGE_NAME                   = QcomPkg
  PACKAGE_GUID                   = 8F99F539-2EE4-4A97-BD6E-FA412A26A06A
  PACKAGE_VERSION                = 0.1

[Protocols]
  # Test Protocol    #新增
  gEfiTestProtocolGuid =         { 0x13e277b3, 0xe631, 0x41ca,{ 0xb4, 0xb5, 0x75, 0x9d, 0x7f, 0x2f, 0xed, 0xd9 } }

注意：此处的guid 和前面的FILE_GUID不是同一个，guid类似一个身份证，FILE_GUID指代的是TestDxe.inf 文件，而gEfiTestProtocolGuid 指代的是整个Test驱动。

3、定义驱动及头文件

3.1 修改 boot_images/QcomPkg/Drivers/TestDxe/TestDxe.c 文件

  • TestEntryPoint 入口函数
  • gEfiTestProtocol 驱动定义

将 gEfiTestProtocolGuid 与 gEfiTestProtocol 结构体绑定起来，通过 gEfiTestProtocolGuid 就能获取 gEfiTestProtocol 中的驱动函数和数据。

#include <Uefi.h>
#include <Library/BaseLib.h>
#include <Library/MemoryAllocationLib.h>
#include <Library/DebugLib.h>
#include <Library/IoLib.h>
#include <Library/PcdLib.h>
#include <Library/UefiBootServicesTableLib.h>
#include <Library/BaseMemoryLib.h>
#include <Library/UncachedMemoryAllocationLib.h>
#include <Library/ArmLib.h>
#include <Library/SerialPortShLib.h>
#include <Library/UefiBootServicesTableLib.h>
#include <Library/StorSecApp.h>
#include <Library/UefiCfgLib.h>
#include <Protocol/BlockIo.h>
#include <Protocol/BlockIo2.h>
#include <Protocol/DevicePath.h>
#include <Protocol/EFICardInfo.h>
#include <Protocol/EFIClock.h>
#include <Protocol/EFIHWIO.h>

#include <Library/GPTListener.h>
#include <Library/RpmbListener.h>
#include <Library/RpmbLib.h>
#include <Protocol/EFIRpmb.h>
#include <Protocol/EFIEraseBlock.h>
#include <Protocol/EFIStorageWriteProtect.h>
#include <Protocol/EFIHALIOMMUProtocol.h>
#include <Library/KernelLib.h>

#include <Protocol/EFITest.h>
#include <errno.h>
#include <stdio.h>

/* 传递函数 */
static char s_TestData[128] = {0};


/* 传递函数 */
EFI_STATUS Test_Printf(void)
{
    DEBUG((EFI_D_ERROR, "%a : test protocols \r\n", __func__));
    return 0;
}

/* 驱动函数结构体 */
EFI_TEST_PROTOCOL gEfiTestProtocol =
{
	EFI_TEST_REVISION,
	Test_Printf,
	s_TestData,
};

// 注册驱动：将 `gEfiTestProtocolGuid` 与 `gEfiTestProtocol` 结构体绑定起来
EFI_STATUS EFIAPI TestEntryPoint(
    IN EFI_HANDLE         ImageHandle,
    IN EFI_SYSTEM_TABLE   *SystemTable
)
{
    EFI_STATUS   status = EFI_SUCCESS;

    memcpy(s_TestData, "test data\n", sizeof("test data\n"));

    /*  Install protocol */
	status = gBS->InstallMultipleProtocolInterfaces(&ImageHandle,
        &gEfiTestProtocolGuid, (void *)&gEfiTestProtocol,
        NULL);

    if (EFI_ERROR(status)) {
        DEBUG((EFI_D_ERROR, "%a : Failed to Install protocols \r\n", __func__));
    }

    return status;
}

3.2 创建头文件 boot_images/QcomPkg/Include/Protocol/EFITest.h

如果定义的驱动需要被其他应用程序调用的话，需要配置头文件，外部应用程序只需要包含当前头文件即可。

在头文件中定义了 驱动的GUID 及 驱动中包含的所有方法，如下：

#ifndef __EFI_TEST_H_
#define __EFI_TEST_H_

#include <stdarg.h>

/*Protocol version. */
#define EFI_TEST_REVISION 0x0000000000010000

/* Protocol GUID definition */
#define EFI_TEST_PROTOCOL_GUID \
        { 0x13e277b3, 0xe631, 0x41ca,{ 0xb4, 0xb5, 0x75, 0x9d, 0x7f, 0x2f, 0xed, 0xd9 } };

extern EFI_GUID gEfiTestProtocolGuid;

/*Raw Message  protocal*/
typedef struct _EFI_TEST_PROTOCOL EFI_TEST_PROTOCOL;

typedef EFI_STATUS (EFIAPI *EFI_TEST_PRINT)();

struct _EFI_TEST_PROTOCOL {
    UINT64                          Revision;
    EFI_TEST_PRINT                  TestPrintf;
    char*                           pData;
};

#endif

二、abl如何调用xbl驱动

前面，我们在xbl中创建了 boot_images/QcomPkg/Drivers/TestDxe/ 驱动，下面，我们来看下它是怎么被应用程序调用的。

使用 Protocol 驱动，需要做如下动作：

  • 在 c文件中包含驱动协议相关的头文件。如： #include <Protocol/EFITest.h>
  • 定义驱动协议的结构体指针。如：EFI_TEST_PROTOCOL *TestProtocol;
  • 加载 gEfiTestProtocolGuid 对应的驱动，将驱动结构体指针保存在TestProtocol 中

        Status = gBS->LocateProtocol (&gEfiTestProtocolGuid , NULL, (VOID **)&TestProtocol );

  • 通这 TestProtocol 结构体指针调用驱动的相关函数。
    Status = TestProtocol->TestPrintf();

下面详细介绍步骤。

1、如何在abl中调用xbl中的驱动

1）新建 abl/QcomModulePkg/Include/Protocol/EFITest.h（可与xbl中 EFITest.h 相同）

#ifndef __EFI_TEST_H_
#define __EFI_TEST_H_

#include <stdarg.h>

/*Protocol version. */
#define EFI_TEST_REVISION 0x0000000000010000

/* Protocol GUID definition */
#define EFI_TEST_PROTOCOL_GUID \
        { 0x13e277b3, 0xe631, 0x41ca,{ 0xb4, 0xb5, 0x75, 0x9d, 0x7f, 0x2f, 0xed, 0xd9 } };

extern EFI_GUID gEfiTestProtocolGuid;

/*Raw Message  protocal*/
typedef struct _EFI_TEST_PROTOCOL EFI_TEST_PROTOCOL;

typedef EFI_STATUS (EFIAPI *EFI_TEST_PRINT)();

struct _EFI_TEST_PROTOCOL {
    UINT64                          Revision;
    EFI_TEST_PRINT                  TestPrintf;
    char*                           pData;
};

#endif

2）QcomModulePkg/QcomModulePkg.dec 中 [Protocols] 添加 gEfiTestProtocolGuid（GUID值和xbl中的一定要相同）

[Protocols]
  # Test Protocol
  gEfiTestProtocolGuid =         { 0x13e277b3, 0xe631, 0x41ca,{ 0xb4, 0xb5, 0x75, 0x9d, 0x7f, 0x2f, 0xed, 0xd9 } }

此时，abl可以使用 xbl中的 gEfiTestProtocolGuid 了

3）新建 QcomModulePkg/Library/TestLib/TestLib.c 和 TestLib.inf，用来将 gEfiTestProtocolGuid 封装一层，abl调用封装后的函数即可调用xbl驱动了。

#include <Uefi.h>

#include <Library/DebugLib.h>
#include <Library/PrintLib.h>
#include <Library/UefiBootServicesTableLib.h>
#include <Library/MemoryAllocationLib.h>
#include <Library/CacheMaintenanceLib.h>
#include <Library/UefiBootServicesTableLib.h>
#include <Library/BaseMemoryLib.h>

#include <Protocol/EFIScm.h>
#include <Protocol/EFIScmModeSwitch.h>
#include <Protocol/EFITest.h>	//包含头文件
#include <stdarg.h>

int test_print(void)
{
	EFI_STATUS Status;
	EFI_TEST_PROTOCOL *TestProtocol;

	Status = gBS->LocateProtocol (&gEfiTestProtocolGuid,
								NULL,
								(VOID **)&TestProtocol);
	if (EFI_ERROR(Status)) {
		DEBUG ((DEBUG_ERROR, "test Protocol Failed %d\n", Status));
		return Status;
	}

	Status = TestProtocol->TestPrintf();
	if (Status)
		DEBUG ((DEBUG_ERROR, "test Local Failed %d\n", Status));

	return Status;
}

int test_get_data(void)
{
	EFI_STATUS Status;
	EFI_TEST_PROTOCOL *TestProtocol;

	Status = gBS->LocateProtocol (&gEfiTestProtocolGuid,
								NULL,
								(VOID **)&TestProtocol);
	if (EFI_ERROR(Status)) {
		DEBUG ((DEBUG_ERROR, "test Protocol Failed %d\n", Status));
		return Status;
	}

    DEBUG ((DEBUG_ERROR, "get xbl data: %a\n", TestProtocol->pData));

	return Status;
}

TestLib.inf 的 [Protocols] 配置 驱动协议的GUID，这里是 gEfiTestProtocolGuid

[Defines]
  INF_VERSION                    = 0x00010005
  BASE_NAME                      = TestLib
  FILE_GUID                      = b0c5efb2-d180-404a-8524-8f222fb27f5c
  MODULE_TYPE                    = BASE
  VERSION_STRING                 = 1.0
  LIBRARY_CLASS                  = TestLib

[BuildOptions]
  RVCT:*_*_*_CC_FLAGS = -DCONFIG_SPL_BUILD
  GCC:*_*_*_CC_FLAGS = -DCONFIG_SPL_BUILD

[BuildOptions.AARCH64]
  GCC:*_*_*_CC_FLAGS = -DCONFIG_SPL_BUILD

[Sources.common]
  TestLib.c					//源文件

[Packages]
  QcomModulePkg/QcomModulePkg.dec
  ArmPkg/ArmPkg.dec
  MdePkg/MdePkg.dec
  StdLib/StdLib.dec
  EmbeddedPkg/EmbeddedPkg.dec
  ArmPlatformPkg/ArmPlatformPkg.dec
  MdeModulePkg/MdeModulePkg.dec

[LibraryClasses]

[Protocols]
  gEfiTestProtocolGuid		//协议

[Depex]
  TRUE

新建 QcomModulePkg/Include/Library/Test.h 头文件

#ifndef _TEST_H__
#define _TEST_H__

int test_print(void);
int test_get_data(void);

#endif /* _TEST_H__*/

4）QcomModulePkg/QcomModulePkg.dsc 中定义 LinuxLoader.inf 包含需要用到的所有inf文件，新增 TestLib.inf，之后LinuxLoader.c就能调用TestLib.c中的内容

[Components.common]
        QcomModulePkg/Application/LinuxLoader/LinuxLoader.inf {
                <LibraryClasses>
                        ... ...
                    	TestLib|QcomModulePkg/Library/TestLib/TestLib.inf	#新增
        }

此时，LinuxLoader.c可以调用 test_print() 和 test_get_data()。

[LibraryClasses]
	... ...
	TestLib
#include <Library/Test.h>

... ...
/* 调用测试 */
  test_print();
  test_get_data();

三、测试结果

串口打印结果可以看到，执行了 xbl 中 protocol 驱动内容

hinewcc
关注
专栏目录
如何在xbl中读取分区信息.docx
05-09
android qcom 在XBL中读取分区
高通UEFI，ABL,XBL控制GPIO
arden3227的博客
10-24 1564
高通EUFI分了ABL,XBL两部分ABL类似于lk,xbl类似preload，但也有不同。ABL的主要代码在从名字看属于应用，是检查状态进入recovery mode或者Normal模式。对于关机充电的判断和控制比较关键的是。
安卓系统 XBL阶段详解
最新发布
flomingo1的专栏
08-27 1163
定义：XBL是安卓系统启动过程中的一个扩展引导加载程序（Secondary Bootloader），有时也被称为SBL（Secondary Bootloader），它是UEFI（Universal Extensible Firmware Interface）架构中的一部分，用于在PBL（Primary Boot Loader）之后进一步初始化硬件和加载系统。作用硬件初始化：XBL负责进行更深入的硬件初始化，如CPU、内存、时钟等，为系统启动做好准备。加载和验证。
abl如何调用xbl里面的protocol
jlgcumt的博客
06-02 1225
参考：高通文档 How to use SMEM in ABL? For previous platform, Android LK was used for bootloader, while in recent platforms UEFI is used to replace the old Android LK bootloader. There are two parts of UEFI modules, one is in boot_images which is called UEFI core
我所理解的高通UEFI之display的流程和移植
weixin_42432281的博客
02-11 4664
UEFI跟uboot一样在OS加载启动之前，正确的指定启动服务，并向内核传递信息，代替原先的uboot。它包含了上电、驱动实现，以及os环境的建立和应用程序（类似于fastboot）。这个os是UEFI自己独立运行独有。
高通UEFI
Y_1996_Y的博客
03-09 1137
不同的厂商对UEFI有不同的实现，一种比较常用的开源实现是EDK2；不同的厂商对UEFI有不同的实现，一种比较常用的开源实现是EDK2；UEFI代码中大量使用了protocol概念，这个protocol其实指的是驱动，包含了驱动函数指针和数据。在老版本中，LK的设备驱动都放在了XBL核心，Linux加载启动及fastboot等功能组件则作为独立的UEFI应用存在。用于移动通信的android设备（如手机平板）：软件小巧，架构简单，满足android bootloader的基本需求。
高通XBL阶段读取分区
sunnywalden
02-24 1164
高通XBL阶段读取分区
8155-XBL分析
kill150的专栏
04-03 5646
XBL本质上是UEFI（Unified Extensible Firmware Interface），所以在编译的时候遵循的是UEFI的编译方法和规则。下载软件包，解压之后，可以看到XBL的源码目录:boot_8155。指令的含义是：编译AU变种的release版本，编译的包包括。文件中解析出要编译的模块。python脚本buildex.py会根据。
高通Android msm8953 驱动开发（一）--LCD调试
u011360996的博客
07-01 6697
本篇记录Andoird9 高通msm8953 ili9881c LCD调试过程，主要涉及到以下几个知识点： (一).利用GCDB生成lk 头文件和 kernel dts，点亮屏幕； (二).LCD兼容; （三).LCD方向调整;
XBL(Exec Bin Lib)
08-18
在XBL的实现中，它包含了对DOS和Linux系统调用的封装，这样程序就可以在不修改源代码的情况下，通过XBL库在两种不同的操作系统上运行。这种跨平台的能力对于开发者来说是一个巨大的便利，特别是在20世纪90年代，当...
xbl:xbl.js - JavaScript 中的跨浏览器 XBL 2 实现
05-31
这是 JavaScript 中的 XBL 2 实现。 除了 [ 2.0) 语言，它还包含 [ API)支持 [ 3 Selectors) 以及 [ Extensions to CSS)、[ （文档对象模型 (DOM) 级别 3 事件）和 [ 基础)。 < head > ... < script ...
xbl中的属性继承与事件继承实例
05-05
总结了xbl中的继承用法,属性继承和事件继承 本资源为火狐扩展
EIKI爱其LC-XBL20 用户手册.pdf
02-13
EIKI爱其LC-XBL20多媒体投影机用户手册 本手册为EIKI爱其品牌的LC-XBL20多媒体投影机提供了详细的使用说明书。该投影机采用了最新的技术，具有便携、耐用、易于操作等特点，适合广泛的应用场景。 多媒体投影机的...
Android的启动流程
JoggingPig的博客
07-20 3588
1.Android的启动流程图 2.基于QualComm SOC的设备启动流程 PBL（Primary Boot Loader）→ XBL（eXtensible Boot Loader/Secondary bootloader） → ABL（Application bootloader）→ Kernel→ Android PBL：主引导加载程序，固化在ROM上；（类似于PC的BIOS） QualComm bootloader 采用UEFI（Universal Extensib...
高通UFEI和MTK
aa541850383的专栏
05-26 1735
高通在MSM8998上引入了UEFI，用来代替LK(Little Kernel)。 而高通UEFI由XBL和ABL两部分组成。 XBL负责芯片驱动及充电等核心应用功能。 ABL包括芯片无关的应用如fastboot。ABL则在开源Linux Android代码树里。 对于高通平台启动过程依次为：PBL->XBL->ABL。 一般用户定制化主要集中在ABL中， android 默认bootloader为什么选择lk ......
【高通SM8250 Android S bootloader XBL代码编译】
maxiaobang的博客
02-16 1113
高通 Android S XBL
《高通QCS8250》Debug XBL开机启动、进入fastboot花屏问题
m0_57123509的博客
10-15 1478
问题描述： 1.问题简介 在系统开机启动，865平台在bootloader过程中和进入fastboot模式会出现花屏情况，情况如下：（图一是花屏显示，图二是调试正常显示） 图一： 图二： 调试记录： 针对上述问题: 分析了产生的可能原因，重点排查产生问题的情况，原以为在分析的原因中，可以解决这个花屏问题，可是不如人愿。 重新审视问题：按照正常调试流程，debug dsi-mipi信号，把必要要求：电压，reset时序，屏参，format，clk逐一验证排除，没有进展。 突发奇想，改变屏的条件，在xbl
高通 UEFI:ABL(一）
weixin_43453149的博客
03-26 6327
高通平台下的UEFI由XBL+ABL组成，主要完成各种客制化的需求实现，例如通过拉特定的gpio进入fastboot/recovery模式，读取ufs寿命，LCD兼容框架的实现等，想要实现客制化首先要搞明白源码种的框架组成，这篇文章先剖析一下abl阶段主要做了什么事情。要分析abl框架，首先我们需要找到整个框架的入口，根据LinuxLoader.inf内的描述可以得到，abl的入口就在LinuxLoader.c内的LinuxLoaderEntry函数。
abl调用xbl协议的原理
06-09
ABL (Advanced Business Language) 是 Progress Software 公司的一种高级商务语言，用于开发企业级应用程序。而 XBL (XML Binding Language) 是一种基于 XML 的数据绑定语言，用于将 XML 数据与应用程序中的对象进行绑定。ABL 调用 XBL 协议的原理如下： 1. ABL 应用程序通过调用 XBL 解析器解析 XML 数据，并将解析后的数据转换为 ABL 中的数据类型。 2. ABL 应用程序通过 XBL 协议指定的方法来访问 XML 数据，并将 XML 数据与 ABL 应用程序中的对象进行绑定。 3. 一旦 XML 数据与 ABL 应用程序中的对象进行了绑定，就可以通过 ABL 应用程序来访问和处理 XML 数据，实现对 XML 数据的操作和处理。 需要注意的是，ABL 调用 XBL 协议的原理是基于 XML 数据绑定技术实现的，因此需要在 ABL 应用程序中引入 XBL 解析器和 XBL 协议的相关类库和组件。同时，还需要了解 XBL 协议的详细规范和使用方法，才能够正确地进行 XML 数据绑定和操作。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值