第2章　ABL模块入口实现

2.1 入口函数原型

ABL（Android Bootloader）作为一个UEFI应用程序，其入口函数遵循UEFI驱动模型，但名称和约定与标准EDK II框架有所区分。典型ABL入口原型如下：

EFI_STATUS
ABL_ENTRY_POINT (
  IN EFI_HANDLE           ImageHandle,
  IN EFI_SYSTEM_TABLE    *SystemTable
);

习惯上，ABL代码中将该函数命名为 abl_entry 或 BootloaderEntry，具体名称由编译时的固件集成者确定。入口点通过UEFI图像加载器从 .efi 文件的PE头中解析并调用。

2.2 参数含义详解

两个参数 ImageHandle 和 SystemTable 分别承载ABL自身的模块上下文和全局UEFI运行时服务。具体含义如下表：

在ABL实现中，入口函数第一件事通常是将 SystemTable 保存到全局变量，以便后续阶段能持续访问UEFI服务。典型的初始化片段：

EFI_STATUS
abl_entry(IN EFI_HANDLE ImageHandle, IN EFI_SYSTEM_TABLE *SystemTable)
{
  EFI_STATUS Status;

  gImageHandle = ImageHandle;
  gST = SystemTable;
  gBS = SystemTable->BootServices;
  gRT = SystemTable->RuntimeServices;

  // 注册退出启动服务回调
  Status = gBS->RegisterProtocolNotify(&gEfiEventExitBootServicesGuid,
                                        TPL_CALLBACK,
                                        ExitBootServicesCallback);
  ...
}

2.3 与UEFI Entry Point的区别

标准UEFI应用程序入口（例如EDK II生成的 efi_main）与ABL入口在调用约定、资源初始化阶段、以及生命周期方面存在本质差异。下表逐项对比：

2.4 入口点之后的初始化流程

ABL入口函数内部典型执行顺序：

1. 保存SystemTable并禁用看门狗。
2. 获取平台设备路径，枚举当前存储设备上的分区。
3. 搜索并解析引导配置文件（boot.img、vendor_boot.img 或 UEFI分区）。
4. 验证签名并加载内核、DTB、ramdisk到物理内存。
5. 设置页表、为ExitBootServices做准备。
6. 调用 gBS->ExitBootServices(ImageHandle, MapKey) 并将控制权交给内核。

下面结构图展示了ABL入口在UEFI阶段中的位置及参数流向：

上图清晰展示了ABL入口在UEFI阶段的承接位置：经过SEC、PEI、DXE三层逐级初始化后，BDS阶段调用ABL入口，并传入 ImageHandle 和 SystemTable。右侧的说明框总结了与标准UEFI入口的核心区别，便于开发者快速定位差异点。