UEFI Application là gì?

UEFI Application là chương trình chạy trong môi trường UEFI, thường được load từ UEFI Shell, Boot Manager hoặc chain boot. Nó rất phù hợp để học UEFI vì ít phụ thuộc dispatcher/DEPEX hơn DXE driver.

Nếu bạn mới muốn thử GetVariable(), dump memory map, locate protocol hoặc đọc file từ ESP, UEFI Application thường là điểm bắt đầu dễ nhất.

Entry point tối giản

#include <Uefi.h>
#include <Library/UefiLib.h>
#include <Library/UefiBootServicesTableLib.h>

EFI_STATUS
EFIAPI
UefiMain (
  IN EFI_HANDLE        ImageHandle,
  IN EFI_SYSTEM_TABLE  *SystemTable
  )
{
  Print (L"Hello from UEFI app\n");
  return EFI_SUCCESS;
}

INF tương ứng:

[Defines]
  INF_VERSION                    = 0x00010017
  BASE_NAME                      = MyApp
  FILE_GUID                      = 55555555-6666-7777-8888-999999999999
  MODULE_TYPE                    = UEFI_APPLICATION
  ENTRY_POINT                    = UefiMain

[Sources]
  MyApp.c

[Packages]
  MdePkg/MdePkg.dec

[LibraryClasses]
  UefiApplicationEntryPoint
  UefiLib
  UefiBootServicesTableLib

Chạy từ UEFI Shell

fs0:/
└─ EFI/
   └─ Tools/
      └─ MyApp.efi

Trong shell:

Shell> fs0:
FS0:\> cd EFI\Tools
FS0:\EFI\Tools> MyApp.efi
Hello from UEFI app

Ứng dụng thực tế

UEFI Application rất hữu ích để viết tool nhỏ:

• dump BootOrder, BootNext, BootCurrent;
• gọi GetVariable() để đọc NVRAM;
• locate SimpleFileSystemProtocol để đọc ESP;
• dump memory map trước ExitBootServices();
• test protocol do DXE driver của bạn publish.

Cẩn thận với Boot Services

UEFI Application chạy trước khi OS gọi ExitBootServices(). Sau mốc đó, Boot Services không còn dùng được. Vì vậy tool/app nên hiểu rõ service nào là Boot Services, service nào là Runtime Services.

Ghi nhớ nhanh

UEFI Application là cách nhanh nhất để biến kiến thức UEFI thành tool chạy thật. Trước khi viết DXE driver phức tạp, hãy thử viết app nhỏ để dump variable, protocol hoặc memory map.

Bài liên quan

• UEFI Driver Model là gì?
• PCD trong EDK II là gì?

Nguồn tham khảo public

• EDK II Module Writer’s Guide